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This manual now contains information on two VS1 Selectable Units: 

• SU 6 - OS/VS1 Subsystem Attachment Support (SU ID 5741 -606) 

• SU 21 — OS/VS1 Programmed Cryptographic Facility, Program Number 

5740-XY5 (SUID 5741-621) 

Subsystem Attachment Support documentation formerly published in Supplement 
GC24-5129-0 is now included in this manual. This support uses SMF record type 
51 for subsystem data. 

The Programmed Cryptographic Facility is an IBM Program Product. It generates 
SMF record type 82 for security data. 

A number of minor clarifications and corrections have also been made throughout 
this manual. 
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Programming Features 

• IBM 3800 Printing Subsystem - New fields have been appended to SMF record 
type 6 to gather accounting information for the IBM 3800. 

• RTAM — A new field has been added to SMF record type 44 to record modi- 
fications to the characteristics of remote workstations. 

• ACF/VTAM — A new SMF record type (50) has been added to aid in gathering 
ACF/VTAM tuning statistics. 

Publication Features 

• Notes regarding the generation of VSAM records (SMF record types 62, 63, 64, 
67, 68, and 69) by system tasks have been added. 

• Notice of an exit routine restriction to the effect that VSAM data sets are not 
supported for SMF exits from the system reader, writer, RTAM, or VTAM has 
been included. 

• The suffix "R" (signifying RTAM) has been dropped from references to record 
types 43 - 45 and 47 - 49 . 

• A number of minor clarifications and corrections have been made throughout 
this manual. 
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This publication is a major revision of OS/VS System Management Facilities (SMF), 
order number GC35-0004-6. It contains only VS1 information. 

Programming Features 

• RTAM — New fields have been added to SMF record types 43R-45R to reflect 
the modifications made to RES to support SNA devices. Where applicable, 
RTAM additions have also been made to the text and to the IFASMFR macro 
instruction. 

• Record type 22 (Configuration) — The 40 bytes describing the 3850 Mass 
Storage System (MSS) units online at IPL have been defined. 

• Record type 64 (VSAM Component Status) — Five new record fields describing 
data set characteristics have been added. 

• SMF dump program return code — A X'10' return code in register 15 indicating 
that the operator attempted to dump the active SMF data set has been added. 

• Modifying JCL statements — A restriction for adding or modifying JCL-statement 
operand fields has been added to the IEFUIV and IEFUJV exits. 

Publication Features 

• VS2 information — All VS2 information has been removed. 

• Dumping the SMF data sets — Two sample procedures for dumping the SMF 
data sets to a standard-labeled tape by means of the operator START command 
have been added. 

• User-written exit routines — The modules that interface with each SMF exit 
routine have been added. 

• SMF records — The following information has been added to the SMF records: 

— The modules that write each SMF record. 

— The symbolic addresses of the SMF record fields as defined in the IFASMFR 
macro instruction. 

— The data area fields where SMF obtains the information for each field in each 
SMF record. 

• Record descriptor word (RDW) — A note indicating that the address passed to the 
SMFWTM macro instruction must point to the RDW has been added. 

• Storage protect keys — A statement indicating that all user-written exit routines 
receive control with the system enabled for interrupts and in storage protect key 
has been added. 

• Figure on SMF in the operating system — The system routines that pass control 
to the SMF exits have been added. 

• SMF storage requirements — Figure 6 has been added to summarize the additional 
storage required for SMF. 

• IEFUTL interlock warning — A sample ENQ macro instruction has been added to 
assist the IEFUTL user in minimizing the chances of a system interlock. 
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Preface 



The objective of this book is to help installation managers and system programmers 
plan for, install, and use SMF in a VS1 system. This book explains: 

• The five categories of information gathered by SMF data-collection routines. 

• When each SMF record is written and the information contained in each record. 

• The basic relationship of SMF to the operating system and to user-written exit 
routines. 

• How to add SMF to a VS1 operating system by using the SCHEDULR macro 
instruction. 

• How to add user-written exit routines to the appropriate SMF exits either before 
or after SYSGEN. 

• The system areas that require additional storage for SMF and approximately how 
much additional storage is needed in each area. 

• How to execute the SMF dump program. 

• How to use an SMFxxxxx member of SYS1 JPARMLIB to define the use of SMF. 

• How to write records to installation-defined or SMF-defined data sets. 

• How to plan and write exit routines that will monitor jobs or job steps at various 
points during their processing cycle. 

• How to test user-written exit routines using the TEXTEXIT procedure. 

• How to use sort/merge programs to sequence SMF data. 

• How to design report programs that format and print the data from SMF records. 

Related Publications 

The reader should be familiar with the information presented in the following 
publications: 

• Operator 's Library: IBM 3850 Mass Storage System (MSS) Under OS/VS, 
GC35-0014, describes the VARY ONLINE,S and VARY OFFLINE,S commands, 
which cause SMF to produce record type 22. 

• Operator's Library: OS/VS1 Reference, GC38-01 10, describes the HALT EOD 
and SWITCH SMF commands, which dump the SMF data sets; it also describes 
several other commands that cause SMF to produce records. 

• OS/VS Data Management Services Guide, GC26-3783, describes the record 
descriptor word (RDW), which is used to write records in the SMF data sets. 

• OS/VS Message Library: VS1 System Codes, GC38-1003, defines system 
completion codes. 

• OS/VS Message Library: VS1 System Messages, GC38-1001 , explains SMF 
messages. 

• OS/ VS1 Programmer's Reference Digest, GC24-5091 , lists the resource names 
used by system tasks. 
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• 0S/VS1 Supervisor Services and Macro Instructions, GC24-5 1 03 , provides 
detailed information on return codes from the ENQ macro instruction. 

• OS/VS1 Utilities, GC26-3901 , describes the IEBUPDTE, IEBDG, IEBPTPCH, 
and IFASTATR utility programs, which are used to: 

1) enter an SMFxxxxx member into SYS1.PARAMLIB, 

2) generate samples of standard parameter lists for user-written exit routines, 

3) obtain listings of sample routines, and 

4) format and write information from SMF record type 21 . 

• OS/VS-VM/370 Assembler Programmer's Guide, GC33-4021 , illustrates the 
ASMFCL cataloged procedure, which assembles and link-edits user-written exit 
routines. 

• OS/VS1 JCL Reference, GC24-5099, summarizes the OUTLIM parameter, which 
is used with user-written IEFUSO exit routines. 

• OS/VS1 Planning and Use Guide, GC24-5090, has information on how to handle 
accounting information when SMF=BASIC is specified, and how to use SMFxxxxx 
parameters when automated system initialization (ASI) is used. 

• OS/VS1 RES: System Programmer's Guide, GC28-6878, has information on 
remote entry services and RTAM, for which SMF produces record types 
4345 and 47-49. 

• Advanced Communications Function for VTAM (ACF/VTAM) System 
Programmer's Guide, SC38-0258, has information on ACF/VTAM, for which 
SMF produces record type 50. 

• OS/VS1 and OS/VS2 MVS Programmed Cryptographic Facility General 
Information Manual, GC28-0942, describes the cryptographic facility that uses 
SMF record type 82. 

• OS/VSI System Data Areas, SY28-0605, describes the TIOT, JFCB, DCB, DEB 
and UCB data areas contained in SMF record types 14 and 15. 

• OS/VSI Virtual Storage Access Method (VSAM) Logic, SY26-3841 , describes 
the VSAM catalog records contained in SMF record types 63 and 67. 

(For information on the PL/1 and Sort/Merge program products, see PL/1 Language, 
SC33-0009, and OS/VS Sort/Merge Programmer's Guide, SC33-4035.) 

Notatipnal Conventions 

The parameters and instructions shown in this publication use the following 
notational conventions: 

• Bold type letters, words, and symbols: code them exactly as shown. 

• Italic type letters, words, and symbols: substitute specific information. 

• ty (blank characters): code a blank. 

• { } (braces): code only one of the items or use the default value. Do not code 
the braces. 

• [] (brackets): code any enclosed item or items — they are optional. Do not 
code the brackets but specify commas if they are included with the items 
enclosed in the brackets. 

• | (OR signs): select only one of the items separated by the OR signs. 

• Underscores: if you do not code a value, the underscored one is the default. 
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Introduction 



SMF (System Management Facilities) is an optional feature of OS/VS1 that collects 
and records several types of information: 

• Accounting information, such as CPU time, device usage, and storage usage. 

• Data set information, such as EXCP count and user identification. 

• Subsystem information, such as RTAM start and stop times. 

• System information, such as system wait time and I/O configuration. 

• Volume information, such as space available on direct access volumes and error 
statistics for tape volumes. 

By creating analysis and report routines, installation managers or system 
programmers can use SMF-collected information in a variety of ways. For instance, 
they can use it for accounting system usage or for measuring system performance. 

Note: SMF does not collect or record information for system tasks; for example, 
SMF does not supply information for JES. 

SMF also has exits that can link to user-written routines for monitoring a job or 
job step at various points during its processing cycle. The user-written routines can 
perform functions such as: cancel jobs, write user-defined records to the SMF data 
set, access installation-defined data sets, or enforce standards such as user 
identification, resource allocation, and maximum execution time. 

Because SMF data-collection routines and exit routines are independent of one 
another, one can use them in combination or separately. For example: by 
analyzing the information obtained by SMF data-collection routines, an installation 
manager can estimate a time limit for all jobs or job steps running on the system. 
Any job exceeding this time limit is automatically terminated. If, however, the 
installation manager would like to allow certain jobs to exceed the time limit, he or 
she can use the IEFUTL SMF exit to link to a user-written time-limit routine. 
Through the IEFUTL SMF exit, the execution time for selected jobs can be extended. 



Information Collected by SMF 



The information collected by SMF is formatted into many records that are 
categorized as follows: 

• Accounting records 

• Data set records 

• Subsystem records 

• System records 

• Volume records 
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The following sections list the types of records in each of these categories, and 
describe some of the information they contain. For a detailed description of each 
SMF record and its format, see the chapter "SMF Records". 

Accounting Records 

The SMF accounting records are: 

Type 4 - Step Termination 
Type 5 — Job Termination 
Type 6 — Output Writer 
Type 20 — Job Initiation 

These records describe the resources used by a job or job step. They include 
information such as: 

• Job log and user identification 

• Problem program name and start time 

• Step name and number 

• Job/step start and end times 

• Amount of storage allocated and used 

• Storage protect key 

• Job/step priority 

• User's logon identifier 

• Job/step CPU time 

• Accounting fields from JOB and EXEC statements 

• I/O status indicators 

• Job/step termination status 

• Job/step completion code 

• EXCP count, device class, unit type, and channel/unit addresses 

• Page-ins and page-outs done to each partition 

• SYSOUT class and SYSOUT start and end times 
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Data Set Records 

The SMF data set records are: 

Type 14 - INPUT or RDBACK Data Set Activity 

Type 15 - OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity 

Type 17 - Scratch Data Set Status 

Type 1 8 — Rename Data Set Status 

Type 62 — VSAM Component or Cluster Opened 

Type 63 - VSAM Entry Defined 

Type 64 — VSAM Component or Cluster Status 

Type 67 - VSAM Entry Deleted 

Type 68 - VSAM Entry Renamed 

These records describe the characteristics, activity, and user of data sets. They 
include information such as: 

• Job log and user identification 

• Portions of the TIOT, JFCB, DCB, DEB and UCB data areas 

• Data set and catalog names 

• Number of volumes 

• Volume serial numbers 

• Extents on volume 

• EXCP count and device type 

• Number of records in data component 

• Record formats and lengths 

• Newly defined, altered, or deleted catalog entries 

Subsystem Records 

The SMF subsystem records are: 

Type 43 - RTAM Start 

Type 44 - RTAM Modify 

Type 45 - RTAM Stop 

Type 47 - RTAM Logon 

Type 48 - RTAM Logoff 

Type 49 - RTAM Integrity 

Type 50 - ACF/VTAM Tuning Statistics 

Type 5 1 — Subsystem Data 

Type 82 — Security 

Record types 43 through 49 describe the activities and events of the remote ter- 
minal access method (RTAM). They include information such as: 

• Maximum number of readers and writers supported 

• Number of line and logical port DCTs 

• Line numbers and channel/unit addresses 

• QID entries 

• Types of MODIFY or STOP operator commands 

• LOGON records 

Record type 50 maps data useful in adjusting certain ACF/VTAM and NCP 
sysgen and START command variables to improve ACF/VTAM performance. 
Record type 51 is a standard record header for use by subsystems, which specify 
the length and content of the record. Record type 82 describes the events and 
operations of the Programmed Cryptographic Facility (Program Number 
5740-XY5). 
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System Records 


The SMF system records are: 


TypeO - 


-IPL 


Type 1 - 


- System Statistics 


Type 2 - 


- Dump Header 


Type 3 - 


- Dump Trailer 


Type 7 - 


- Data Lost 


Type 8 - 


- I/O Configuration 


Type 9 - 


-VARY ONLINE 


Type 10- 


- Allocation Recovery 


Type 1 1 - 


- VARY OFFLINE 


Type 12 - 


- End-of-Day 


Type 13 - 


- Dynamic Storage Configuration 


Type 22 - 


- Configuration 



These records describe the system configuration and SMF options in effect, give 
system statistics, and record the occurrence of specific events. They include 
information such as: 

• Job log and user identification 

• SMF options 

• Real and virtual storage sizes 

• System wait time 

• System page-ins, page-outs, and page reclaims 

• Count of SMF records generated but not written during period when SMF data 
sets were not available for writing 

• Start and end times of period without SMF recording 

• Device class, unit type, and channel/unit addresses 

• Storage assigned to each partition 

• Partition number and job class 

• MSS units online at IPL 
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Volume Records 

The SMF volume records are: 

Type 1 9 — Direct Access Volume 

Type 21 — Error Statistics by Volume 

Type 69 - VSAM Data Space Defined, Extended, or Deleted 

These records describe the space available on direct access volumes, give error 
statistics for tape volumes, and describe data spaces in a VSAM catalog. By using 
the IFHSTATR utility program or user-written routines that examine the tape 
information, one can address problems of volume deterioration. (See "IFHSTATR" 
in OS/VS Utilities.) The volume records include information such as: 

• Number of unused alternate tracks 

• Number of unallocated cylinders and tracks 

• Number of cylinders and tracks in the largest free extent 
t Owner identification 

• Volume serial number 

• Channel/unit addresses 

• Number of read and write errors - / 

• Volume on which data space is allocated 

• Catalog in which data space is defined 

• Number of free data space extents 



SMF in the Operating System 



Figure 1 summarizes the functions of SMF in the operating system. This section, 
which briefly describes Figure 1 , assumes that user-written exit routines are supplied 
for all SMF exits; all SMF-formatted records are written to the SMF data set; and 
user-written analysis and report routines are supplied. In any real application, of 
course, the user-written routines that are supplied and the records that are specified 
to be written to the SMF data set depend upon the installation's requirements. 

Initializing SMF 

During system initialization, the SMF initialization routine receives control from the 
master scheduler and: 

1 . Checks for the existence and validity of an SMFxxxxx member of 

SYS1 .PARMLIB. This member contains the SMF parameters that define the 
use of SMF in the operating system. If SYS1 .PARMLIB does not contain an 
SMFxxxxx member, (1) the operator may enter the SMF parameters from the 
console, or (2) the initialization routine uses the IBM-supplied default member 
SMFPRMOO. (For more information, see "SMFxxxxx Parameters" in the 
chapter "Defining the Use of SMF".) 
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2. Checks for the existence and availability of the SMF data sets, 

SYS1 .MANX and SYS1 .MANY, if SMF recording was requested. If an error 
occurs, a message is issued indicating that recording on the SMF data sets is 
not allowed until the condition is corrected and the IPL procedure is repeated. 
If no errors occur, the initialization routine determines which SMF data set 
should receive records, as follows: 

If neither data set contains data, SYS1 .MANX receives the SMF records. 
If one data set contains data and the other one is empty, the partially 
filled data set receives the records. If both data sets contain data, the data 
set with the lesser amount of data receives the records. 

3. Creates the IPL record (type 0), the I/O configuration record (type 8), the 
system statistics record (type 1 ), and the configuration record (type 22). 
These records are then written to the SMF data set. 

After the SMF initialization completes without error, the initialization routine 
returns control to the master scheduler so that processing of input streams may 
begin. 

Using User-Written Exit Routines 

As the input stream control routine reads each job, it passes control to the SMF 
input stream validation exit, IEFUIV. A user-written IEFUIV exit routine can verify 
whether the job is to be accepted or rejected for processing. 

Before each job control statement (or cataloged procedure) in the input stream is, 
interpreted, job management passes control to the SMF job validation exit, IEFUJV. 
A user-written IEFUJV exit routine can verify any fields in the JCL statement, 
modify the JCL, or reject jobs that do not meet installation standards. After all the 
JCL is interpreted, the same user-written IEFUJV exit routine receives control for 
further validity checking. 

Before the initiator selects a job, it passes control to the SMF job initiation exit, 
IEFUJI. In a user- written IEFUJI exit routine, the user can decide whether to 
cancel or continue job processing based on accounting parameters associated with 
the job. Upon return from the routine, SMF creates the job initiation record 
(type 20) and writes it to the SMF data set. Similar processing occurs for each job 
step: before the initiator selects a job step, it passes control to the SMF step 
initiation exit, IEFUSI. 

When a job step terminates, either normally or abnormally, SMF produces a job 
step termination record (type 4) and, before the record is written, the terminator 
passes control to the SMF termination exit, IEFACTRT. A user-written IEFACTRT 
exit routine can modify the SMF type 4 record and create user records. It can also 
write these records to installation-defined or SMF-defined data sets. A user-written 
IEFACTRT exit routine also indicates whether the job is to continue and whether 
the type 4 record is to be written to the SMF data set. (Upon return, the type 4 
record is written unless the user- written IEFACTRT exit routine suppresses it.) 
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At job termination, SMF produces a job termination record (type 5) and, before 
the record is written, the terminator again passes control to the SMF termination 
exit, IEFACTRT, for similar record modification. (Upon return, the type 5 record 
is written unless the user-written IEFACTRT exit routine suppresses it.) 

After a job has terminated and all the SYSOUT output that pertains to the job 
(including the SMF output writer record (type 6)) is written, the SYSOUT writer 
passes control to the SMF job purge exit, IEFUJP. A user-written IEFUJP exit 
routine can write additional data statistics to the SMF data set. 

Recording Events 

For specific events, SMF collects and formats the following types of information: 

• Configuration information is recorded when a DEFINE or VARY operator 
command is issued and after allocation recovery. 

• Data set information is recorded when a data set opened by a user program is 
scratched, renamed, closed, or processed by end-of-volume (EOV). 

• Direct access volume information is recorded for online, direct access devices at 
IPL; when a HALT EOD or SWITCH SMF operator command is issued; and 
when a volume is demounted. 

• Subsystem information is recorded when START, MODIFY, and STOP 
subsystem operator commands are issued and when an invalid password is used. 

• System information is recorded for ten-minute intervals of CPU-processing time, 
and when a HALT EOD or SWITCH SMF operator command is issued. 

The following SMF exits also receive control whenever specific events occur: 

• The time limit exit, IEFUTL, receives control from the timer interruption 
handler when the step CPU, job CPU, or continuous wait time limits are reached. 

• The SYSOUT limit exit, IEFUSO, receives control from JES when the number of 
records written to an output data set exceeds the output limit for that data set. 

• The SMF record exit, IEFU83 , receives control from the SVC 83 routine when 
an SMF record is ready to be written to the SMF data set. 

Dumping SMF Data Sets 

SMF initially writes records to the SYS1.MANX data set until it becomes full. 
When SYS1 .MANX is full, SMF opens and uses the SYS 1 .MANY data set to 
continue recording. Whenever SYS1 .MANX or SYS1 .MANY becomes full, SMF 
notifies the operator to use the SMF dump program to copy the full data set to a 
dump data set (usually on tape). For a detailed description and sample uses of the 
SMF dump program, see "Dumping the SMF Data Sets" in the chapter "System 
Requirements and Considerations". 



t 
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The operator can use the HALT EOD and SWITCH SMF commands to cause 
SMF to switch recording from the active SMF data set to the inactive one. (These 
commands also cause SMF to record system statistics and to empty the SMF buffer 
into the active SMF data set before it is switched.) After the recording is switched, 
the operator can use the SMF dump program to copy the inactive data set to the 
dump data set. The dump data set can then serve as input to user-written analysis 
and report routines. 

Using User-Written Analysis and Report Routines 

In addition to user-written exit routines, an installation may supply various routines 
that can: 

• Sort and merge the SMF records dumped by the operator from the SMF data set. 

• Analyze the sorted SMF data to detect excessive system wait time, inefficient use 
of I/O devices, or any other statistics that might lead to improved system 
throughput. 

• Report the data from selected SMF records and user-written analysis routines in 
an appropriate format. 
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System Requirements and Considerations 



SMF is an optional part of the VS1 system that is selected at SYSGEN time. To 
record SMF data, an installation must define how it will use SMF (see the chapter 
"Defining the Use of SMF"), add user-written exit routines to the control program, 
allocate direct access space for the SMF data sets, and catalog the SMF data sets. 
This chapter describes these requirements as well as SMF storage requirements and 
performance considerations. 

Including SMF in the Operating System 

To add SMF to the VS1 operating system, specify the appropriate parameters in the 
SMF= operand of the SCHEDULR macro instruction at SYSGEN time. There are 
three SCHEDULR parameters for SMF: 

• SMF=NOTSUPPLIED specifies that SMF processing is not to be included in the 
system. If you do not code either the SMF= parameter or the ESV=SMF 
parameter, NOTSUPPLIED is the default. 

• SMF=BASIC specifies that the SMF records are not to be produced and exits 
IEFUSO, IEFACTRT, and IEFUJP are to be included in the system. (For 
further information on handling accounting information when SMF=BASIC is 
specified, see OS/VS1 Planning and Use Guide.) 

• SMF=FULL specifies that the SMF records and exits IEFUIV, IEFUJV, IEFUJI, 
IEFUSI, IEFUTL, IEFUSO, IEFU83, IEFACTRT, and IEFUJP are to be included 
in the system. If you do not code the SMF= parameter and code the ESV=SMF 
parameter, FULL is the default. 

Figure 2 summarizes the exits that are available when SMF=BASIC or SMF=FULL 
is specified. It also shows the times during normal job processing when the SMF 
exits receive control. 



Exit Time 


Exit Name 


BASIC 


FULL 


JES Reader Time 


IEFUIV 


No 


Yes 


Interpretation 


IEFUJV 


No 


Yes 


Job Initiation 


IEFUJI 


No 


Yes 


Step Initiation 


IEFUSI 


No 


Yes 


Timer Expiration 


IEFUTL 


No 


Yes 


Output Limit Expiration 


IEFUSO 1 


Yes 


Yes 


SMF Buffer Time 


IEFU83 


No 


Yes 


Allocation 


IEFACTRT 


Yes 


No 


Step Termination 


IEFACTRT 


Yes 


Yes 


Job Termination 


IEFACTRT 


Yes 


Yes 


Job Purge 


IEFUJP 


Yes 


Yes 



a lf SMF=BASIC or SMF=FULL is specified in the SCHEDULR macro and a user-written 
IEFUSO exit routine is supplied, the IEFUSO routine receives control when the output limit is 
reached. To specify the output limit, use the JOUTLIM parameter of the JES macro instruction 
at SYSGEN time, or the OUTLIM parameter on the DD statement defining the output data set. 
Unless an IEFUSO exit routine is supplied, jobs will be canceled when the output limit is 
reached. 

Figure 2. Exits Available When SMF=BASIC or SMF=FULL 
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Including User-Written Exit Routines In The Operating System 

User-written exit routines are optional — SMF automatically provides dummy 
routines for all unused SMF exits. To include user-written exit routines in the 
operating system; add them to SYS1.AOS00 before generating the system. 
Otherwise, link-edit them into the required system load modules as shown in 
Figure 3. 



i 



Exit Routine 


Descriptive Name 


Required Load Module Assignment for Adding 
User-Written Exit Routine after SYSGEN 


IEFUIV 


Input Stream Validation 


IEFJESinSYS1.LINKLIB 


IEFUJV 


Job Validation 


IEFUJV in SYS1.LINKLIB 


IEFUJI 


Job Initiation 


IEFSD162 in SYS1.LINKLIB 


IEFUSI 


Step Initiation 


IEFSD162 in SYS1.LINKLIB 


IEFUTL 


Time Limit 


IEANUC01 in SYS1. NUCLEUS 


IEFUSO 


SYSOUT Limit 


IEFJESinSYS1.LINKLIB 


IEFU83 


SMF Record 


IEANUC01 in SYS1. NUCLEUS 


IEFACTRT 


Termination 


IEFSD161 inSYSLLINKLIB 1 
IEFW21SD in SYS1.LINKLIB 2 


IEFUJP 


Job Purge 


IEFJES inSYSLLINKLIB 



1 You must link-edit IEFACTRT into this load module if either SMF=BASIC or 
SMF=FULL was specified at SYSGEN time. 

2 You must also link-edit I EFACTRT into this load module if SMF=BASIC was specified. 

Figure 3. Including User-Written Exit Routines in the Operating System 

Note: If a user-written exit routine is link-edited into a load module of an active 
system, a link-edit failure might make that load module inoperative. This is 
particularly important in the case of termination exit routines that direct output to 
SYSOUT because the cause of failure would also be lost. 

When adding exit routines after SYSGEN, refer to your SYSGEN listing for 
exact load module names, aliases, link-edit control statements, and link-edit 
parameters. Specify link-edit parameters according to the characteristics of the 
user-written exit routines. 

Figure 4 shows sample JCL for adding user-written exit routines to 
SYS 1 XINKLIB after SYSGEN. Note that when the IEFUIV, IEFUSO, and 
IEFUJP exit routines become part of IEFJES, they do not become active until the 
next IPL of the system. This is also true for any user-written exit routine that is 
added to a resident load list. 
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Note: Refer to your SYSGEN listing for exact load module names, aliases, 
link-edit control statements, and link-edit parameters. Specify link-edit parameters 
according to the characteristics of the user-written exit routines. 

//EXITLNK JOB MSGLEVEL=1 

//STEP1 EXEC PGM=\EWL,PARM=l(link-editparametersJ 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1.LINKLIB,DISP=(OLD,KEEP) 

//SYSUT1 DD UNIT=SYSDA,DISP=(,DELETE),SPACE=(TRK,(20.5)) 

//SYSLIN DD 

(IEFUJV object deck) 

ENTRY IEFUJV 

INCLUDE SYSLMOD(IEFUJV) 

NAME IEFUJV(R) 

(IEFUJI and IEFUSI object decks) 

ENTRY IEFSD062 

INCLUDE SYSLMOD0EFSD162) 

ALIAS aliasnamel ,aliasname2, . . . 

NAME IEFSD162(R) 

(IEFACTRT object deck) 1 

ENTRY IEFSD061 

ORDER IEFSD515 

INCLUDE SYSLMOD0EFSD161) 

ALIAS aliasnameA^/iasnameB, . . . 

ALIAS aliasnameX^liasnameY, . . . 

NAME IEFSD16KR) 

//STEP2 EXEC PGM=IEWL,PARM= (link-edit parameters) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1.LINKLIB,DISP=(OLD,KEEP) 

//SYSUT1 DD UNIT=SYSDA,DISP=(,DELETE),SPACE=(TRK,(20,5)) 

//SYSLIN DD 

(IEFUIV, IEFUSO, and IEFUJP object decks) 

ENTRY IEFJESCT 

INCLUDE SYSLMOD(IEFJES) 

NAME IEFJES{R) 

/• 

2 You must also link-edit IEFACTRT in load module IEFW21SD if SMF=BASIC was specified 
at SYSGEN time. The required statements for this additional link-edit are as follows: 



ENTRY 


IEFW21SD 


INCLUDE 


SYSLMOD0EFW21SD) 


ALIAS 


aliasnamel ,aliasname2, . 


NAME 


IEFW21SD(R) 



Figure 4. Sample JCL for Adding User-Written Exit Routines to SYS1.LINKLIB after SYSGEN 
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Figure 5 shows sample JCL for adding user-written IEFUTL and IEFU83 exit 
routines to SYS1 .NUCLEUS after SYSGEN. Be aware that when the IEFUTL and 
IEFU83 exit routines become part of SYS 1. NUCLEUS, they do not become active 
until the next IPL of the system. 

Note: Refer to your SYSGEN listing for exact load module names, aliases, 
link-edit control statements, and link-edit parameters. Specify link-edit parameters 
according to the characteristics of the user-written exit routines. 

//NUCLINK JOB MSGLEVEL=1 

// EXEC PGM=\E\NL,PABM=(lfnk-editparameters) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSN=SYS1.NUCLEUS,DISP=OLD 

//SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(2,2)) 

//SYSLIN DD 

Link-edit, INSERT, and ORDER statements required 1 

(IEFUTL and IEFU83 object decks) 

INCLUDE SYSLMOD(IEANUCOI) 
NAME IEANUCOKR) 

/• 

1 These statements are variable according to your SYSGEN; therefore, refer to your SYSGEN 
listing for the link-edit of SYS1. NUCLEUS and copy the link-edit, INSERT, and ORDER 
statement as found there. 

Figure 5. Sample JCL for Adding User-Written IEFUTL and IEFU83 Exit Routines to 
SYS 1.NUCLEUS after SYSGEN 



i 



Storage Requirements 



SMF requires additional real storage in the nucleus, the system queue area (SQA), 
and the partition queue area (PQA). SMF also requires additional auxiliary storage 
for the SMF data sets and for user-written exit routines. Figure 6 summarizes the 
system areas that require additional storage for SMF and the amount of storage that 
is needed in each area. 
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Item 


Additional Storage Required for SMF 


Area in System 


SMF Data-Collection Routines 


2700 bytes plus 148 bytes for each partition 


Pageable Nucleus 


SMF Writer Routine 


1 560 bytes 


Pageable Nucleus 


Timing Control Table (TCT) 
(one is created for each 
active job step) 


lfOPT=1, 116 bytes for each TCT 

If OPT=2, size of each TCT=1 32+1 2(a)+8(b) 

where: a is the maximum number of DD 
statements per job step. 

b is the number of devices allocated 
because of each DD statement. 


Fixed Partition Queue Area (PQA) 


System Management Control 
Area (SMCA) 


1 80 bytes 


Fixed System Queue Area (SQA) 


Common Exit Parameter Area 


1 24 bytes 


Fixed PQA 


SMF Buffer 


400 to 8,192 bytes (See the following section, 
"SMF Buffer.") 


Pageable SQA 


SMF Data Sets 


(See "SMF Data Sets" later in this chapter.) 


DASD 


User-Written Exit Routines 


Size of IEFUIV, IEFUJV, IEFUJI, IEFUSI, 
IEFUSO, IEFACTRT,and IEFUJP user-written 
exit routines 


SYS1.LINKLIB 


Size of IEFUTL and IEFU83 user-written exit 
routines 


SYS1. NUCLEUS 


Work Area for User-Written 
Exit Routines 


Size of user-requested area (See "Obtaining 
Additional Work Areas" in the chapter 
"User-Written Exit Routines") 


Fixed PQA and SQA 



Figure 6. SMF Storage Requirements 



SMF Buffer 

If records are to be written to the SMF data set, you must supply a buffer size in the 
SMFxxxxx BUF parameter before or during IPL. (For detailed information on the 
BUF parameter, see "SMFxxxxx Parameters" in the chapter "Defining the Use of 
SMF".) The minimum SMF buffer size is 400 bytes; the maximum is 8,192 bytes. 

The SMF buffer has two parts: while one half is being filled with SMF records, 
the other half is being written to the SMF data set. If a record size should exceed 
half of the buffer size, the record is segmented before it is written. In order to 
prevent segmenting records (and thereby improve performance), specify a buffer 
size that is at least twice the size of the largest record to be written to the SMF 
data set. 

Figure 7 summarizes the sizes of the SMF records. When calculating the largest 
record size, be sure to include the block descriptor word (four bytes) and the record 
descriptor word (four bytes). Do not make the buffer size larger than necessary; if 
the system should fail, the records in the SMF buffer will be lost. 
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Record Type 


Record Size (in bytes) 





31 


1 


34 


2 


14 


3 


14 


4 


117 + 8 per DD statement + length of step accounting fields 


5 


117 + length of job accounting fields 


6 


99 


7 


24 


8 


16 + 4 per device 


9 


16 + 4 per device 


10 


40 + 4 per device 


11 


16 + 4 per device 


12 


34 


13 


16 + 22 per partition 


14 


264 + 24 per UCB + 28 per ISAM data set 


15 


264 + 24 per UCB + 28 per ISAM data set 


17 


88 + 8 per data set scratched 


18 


1 32 + 8 per data set renamed 


19 


64 


20 


61 + length of job accounting fields 


21 


44 


22 


18 + 42 at IPL + 6 per device varied 


43 


42 + 6 per line created 


44 


30 + 6 per line modified or 9 per user modified 


45 


31 


47 


152 


48 


68 


49 


152 


50 


58 


51 


18 + length of user/subsystem data 


62 


138 + 10 per volume 


63 


132 + length of catalog records 


64 


250 + 26 per extent 


67 


130 + length of catalog records 


68 


170 


69 


102 


82 


41 + length of variable relocate sections (5740-XY5) 



< 



Figure 7. SMF Record Sizes 

Note: If you plan to reduce the SMF buffer size during consecutive IPL's, dump the 
SMF data sets first so that all records will be written with the same block size. 



SMF Data Sets 

You must allocate space for the SMF data sets, SYS1.MANX and SYS1.MANY, 
before IPL. Both data sets must be permanently resident on a direct access device. 
(Several factors, such as specific system configuration, amount of SMF data to be 
written, and report program requirements, will determine which device type is most 
efficient for a particular installation.) You must also catalog SYS 1. MANX and 
SYS1 .MANY. You should not date-protect these data sets because it is possible to 
lock up the system if an SMF record is being processed when a data set switch occurs. 

Figure 8 illustrates sample DD statements for allocating the SMF data sets on 
direct access devices and cataloging them in the system catalog. Note that secondary 
space allocation is ignored. 



//MANX 

II 

//MANY 
II 



DD 



DD 



DSNAME=SYS1.MANX,UNIT=190,VOLUME=SER=1 11111, 
SPACE=(TRK,(20)),DISP=(NEW,CATLG) 
DSNAME=SYS1.MANY / UNIT=191,VOLUME=SER=222222, 
SPACE=(TRK,(20)),DISP=(NEW,CATLG) 



Figure 8. Sample DD Statements for Allocating and Cataloging the SMF Data Sets 
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The amount of space to be allocated to SYS1 .MANX and SYS1 .MANY depends 
upon the amount of data generated by each job and how often the data sets are 
dumped. Figure 9 is an example of how to establish space requirements for an SMF 
data set, given certain assumptions. The values in Figure 9 are calculated for a four 
hour interval. Subsystem records are not shown in this example. 



SYSTEM-RELATED RECORDS 


Event or Status 


Record 
Type 


Assumption for This Example 


Example No. 
of Bytes per 
Record 


Example 
No. of 
Records 


Example 
Total No. 
of Bytes 


IPL 





Once per day 


31 


1 


31 


Devices Online at IPL 


8 


20 devices, including 6 DASD 


96 


1 


96 


19 


64 


6 


384 


22 


60 


1 


60 


Partition Defined 


13 


Once per day (4 partitions) 


104 


1 


104 


End of Day 


12 


Once per day 


34 


1 


34 


19 


6 DASD 


64 


6 


384 


Accumulated Wait Time 


1 


Once every 10 minutes 


34 


24 


816 


Devices Varied Online 


9 


Twice per hour 


20 


8 


160 


22 


1 MSS device per day 


24 


1 


24 


Device Recovered at Allocation 


10 


Once per hour 


44 


4 


176 


Devices Varied Offline 


11 


Twice per hour 


20 


8 


160 


22 


1 MSS device per day 


24 


1 


24 


TOTAL FOR SYSTEM-RELATED RECORDS 


63 


2453 



Figure 9. Sample Data Set Space Requirements (Part 1 of 2) 
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JOB-RELATED RECORDS 


Event or Status 


Record 
Type 


Assumption for This Example 


Example No. 
of Bytes per 
Record 


Example 
No. of 
Records 


Example 
Total No. 
of Bytes 


Job Processing 


5 


Accounting data 1 


129 


1 


129 


20 


73 


1 


73 


19 


Demount 2 DASD volumes 


64 


2 


128 


21 


1 EOV or CLOSE 


44 


1 


44 


Step Processing 


4 


4 DD statements per step, 
accounting data 1 , 3 steps per job 


161 


3 


483 


14 


1 EOV and 2 CLOSE per step, 
3 steps per job 


288 


9 


2592 


15 


1 EOV and 2 CLOSE per step, 
3 steps per job 


288 


9 


2592 


17 


Scratch non-VSAM data set in 
1 step per 1 2 jobs 2 


96 


1 


96 


18 


Rename non-VSAM data set in 
1 step per 1 2 jobs 2 


140 


1 


140 


62 


Open 2 components per step 


168 


2 


336 


63 


Define 1 non-VSAM entry per step 


300 


1 


300 


Define VSAM index cluster in 
1 step per 1 2 jobs 2 


280 cluster 
550 data set 
500 index 


3 


1330 


Alter each component of VSAM 
index cluster per step 


1 1 50 data set 
930 index 


2 


2080 


64 


1 EOV and 1 CLOSE per VSAM 
component 


328 


4 


1312 


67 


Delete non-VSAM entry per step 


300 


1 


300 


Delete VSAM index cluster in 
1 step per 24 jobs 2 


280 cluster 
630 data set 
530 index 


3 


1440 


68 


ALTER rename a VSAM component 
in 1 step per 48 jobs 2 


170 


1 


170 


69 


Define, extend or delete space on 
1 volume in 1 step per 48 jobs 2 


102 


1 


102 


SYSOUT Processing 


6 


2 output writers per step, 

3 steps per job 3 


99 


6 


594 


TOTAL FOR JOB-RELATED RECORDS PER JOB 


52 


14,241 


TOTAL FOR 12 JOBS PER HOUR FOR 4 HOURS 


2026 


529,502 


TOTAL FOR SYSTEM-RELATED AND JOB-RELATED RECORDS 


2089 


532,955 


Record Descriptor Word 


ALL 


N/A 


4 


2089 


8356 


Block Descriptor Word 


N/A 


6 records per block 


4 


348 blocks 


1392 


TOTAL NUMBER OF BYTES FOR THIS EXAMPLE 


531 ,91 1 



Accounting data consists of two 5-byte items. 

The number of bytes for these events is calculated only once for the four-hour interval. 

3 
A type 6 record is issued for each data set destined for an IBM 3800. 

Figure 9. Sample Data Set Space Requirements (Part 2 of 2) 
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Dumping the SMF Data Sets 



When either SYS1 .MANX or SYS 1 .MANY becomes full, the SMF writer routine 
issues a message to the console requesting a dump of the SMF data set. 

The operator should use the SMF dump program, IFASMFDP, to transfer a full 
SMF data set to another data set (usually on tape), and to reset the status of the 
dumped data set to empty so that it can be used again for recording data. 



Figure 10 shows sample JCL for executing the SMF dump program. The output 
is a non-temporary data set on a standard-labeled tape. The operator should record 
the volume serial number of the output data set so that other jobs can reference it. 

//DUMPX JOB MSGLEVEL=1 

//STEP1 EXEC PGM=IFASMFDP 

//DUMPIN DD DSN=SYS1.MAI\K >,DISP=OLD 



»•< 



//DUMPOUT DD DSN=SMFDATA,UNIT=tapeaddr, 

// DISP=(NEW f KEEP),LABEL=(,SL),VOL=SER=serial 

//SYSPRINT DD SYSOUT=A 

Note: Do not specify the DCB= keyword when executing the SMF dump 
program. Although RECFM=VBS for both the SMF data set and the output data 
set, the SMF dump program alternately changes from RECFM=VBS to 
RECFM=VB in order to dump segmented records by individual segments. (See 
Figure 31 for sample JCL describing the output data set SMFDATA.) 

Figure 10. Sample JCL for Executing the SMF Dump Program 

The SMF dump program uses the basic sequential access method (BSAM) to 
physically copy the input data set, DUMPIN, to the output data set, DUMPOUT. 
Dnring the copy process, the dump program creates two SMF records and writes 
them to the output data set : a dump header (record type 2) at the beginning of the 
data set and a dump trailer (record type 3) at the end of the data set. 

The SMF dump program also writes messages, as required, to SYSOUT: 

• The operator must not dump a data set that is being filled. If the operator 
attempts to dump the active SMF data set, IFASMFDP returns a code of X'10' 
in register 15 and writes a message to the console notifying the operator of the 
error. In response, the operator must cancel the dump program and then invoke 
it again to dump the correct data set. 

• If IFASMFDP is unable to open either the input or output data set, it writes an 
error message indicating which data set was not successfully opened. 

• IFASMFDP determines whether the blocksize of the output data set is smaller 
than the blocksize of the input data set. If it is, IFASMFDP writes an error 
message to the console. 

• If both SMF data sets and the SMF buffer become full, SMF will be in a data lost 
condition (unable to record) until dumping takes place. When this condition 
occurs, the lost records are tracked in SMF record type 7 and the operator 
receives a message stating that he or she should dump either data set. 
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One method of executing the SMF dump program is to enter jobs that specify 
the program into the system, and hold them on the job queue until a dump is 
required. Another method is to start a reader to an input stream containing the 
JCL for the SMF dump program. Figure 1 1 illustrates two sample procedures 
(DUMPX and DUMPY) for dumping the SMF data sets to a standard-labeled tape 
(VOL=SER=SMFTAP) by means of the operator START command. In both 
procedures, the default tape specified on the PROC statement is 192. Figure 1 1 also 
illustrates sample JCL for adding these procedures to SYS1 .PROCLIB. 



( 



//UPDATE 


JOB 


MSGLEVEL=1 


//UPDATE 


EXEC 


PGM=IEBUPDTE,PARM=NEW 


//SYSUT1 


DD 


DSN=SYS1.PROCLIB,DISP=SHR 


//SYSUT2 


DD 


DSN=SYS1 .PROCLIB,DISP=SHR 


//SYSPRINT 


DD 


SYSOUT=A 


//SYS IN 


DD 


DATA 


./ 


ADD 


NAME=DUMPX,LIST=ALL 


//DUMPX 


PROC 


TAPE=192 


//SMFDMP 


EXEC 


PGM=IFASMFDP 


//DUMPIN 


DD 


DSNAME=SYS1.MANX,DISP=OLD 


//DUMPOUT 


DD 


DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


II 




LABEL=(,SL),VOL=SER=SMFTAP 


//SYSPRINT 


DD 


SYSOUT=A 


./ 


ADD 


NAME=DUMPY,LIST=ALL 


//DUMPY 


PROC 


TAPE=192 


//SMFDMP 


EXEC 


PGM=IFASMFDP 


//DUMPIN 


DD 


DSNAME=SYS1 .MANY,DISP=OLD 


//DUMPOUT 


DD 


DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


// 




LABEL=(,SL),VOL=SER=SMFTAP 


//SYSPRINT 


DD 


SYSOUT=A 


./ENDUP 
/• 







Figure 1 1. Sample Procedures for Dumping the SMF Data Sets 



Switching the SMF Data Sets 



When an SMF data set becomes full, SMF writes a message to the console and 
automatically switches recording from the active SMF data set to the inactive SMF 
data set. To dump an SMF data set before it becomes full, however, the operator 
can use either the HALT EOD or SWITCH SMF command. (These operator com- 
mands are fully described in Operator's Library: OS/VS1 Reference.) 

When the operator issues either the HALT EOD or the SWITCH SMF command, 
the following actions occur: 



A type 19 record is created for each online direct access device if DSV=1 or 
DSV=3 was specified. 

A type 12 record is created. This record contains the system wait time and 
paging statistics accumulated from the expiration of the ten-minute interval 
reflected in the last type 1 record to the time of the HALT or SWITCH 
command. (The next type 1 record will then contain the system wait time and 
paging statistics accumulated from the HALT or SWITCH command to the 
expiration of the next ten-minute interval.) 

The SMF data sets are switched so that the operator can dump the previously 
active data set. 

Note: When switching the SMF data sets, the inactive data set cannot become 
active unless it is empty. Therefore, the operator must dump the inactive data set 
(or initialize the system) before issuing the HALT or SWITCH command. 
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Performance Considerations 



SMF will reduce system throughput by various amounts depending upon factors 
such as: 

• SMF options selected through the SMFxxxxx parameters. (For a description of 
these parameters, see the chapter "Defining the Use of SMF".) 

• SMF buffer size. (If the buffer size is too small, SMF segments records before 
writing them.) 

• SMF data set size, device type, and dumping requirements. 

• Execution time of user-written exit routines. 

• System configuration, especially the type and degree of multiprogramming. 

• Processing characteristics, such as the number of jobs (the number of records 
generated by SMF is dependent on the number of jobs), the contention for SMF 
resources, and user data set requirements. 
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Defining the Use of SMF 



When SMF=FULL is specified at SYSGEN time, an installation must define how it 
will be using SMF through a SYS1.PARMLIB member SMFxxxxx: 

• Required SMFxxxxx parameters specify the job wait time limit and the system 
on which SMF is active. 

• Optional SMFxxxxx parameters allow an installation to select record types, to 
specify the physical length of SMF records, to permit operator modification of 
SMFxxxxx parameters, and to specify whether SMF exits are to be taken. 

SMFxxxxx parameters are specified (1) before the first IPL of a newly generated 
system by adding SMFxxxxx as a member in SYS1 .PARMLIB, (2) at each 
initialization of SMF by entering SMFxxxxx parameters at the console, or (3) by 
the setup and subsequent use of automated system initialization (ASI). (See OS/VS1 
Planning and Use Guide for specifying SMFxxxxx parameters when using ASI.) 



SMFxxxxx Parameters 



The SMFxxxxx parameters are described in Figure 12. Note that the JWT and SID 
parameters are required for SMF. The BUF parameter is also required unless 
MAN=NONE is specified. 

Note: If a job is recovered in a warm start, the values for the DSV, EXT, OPT, and 
REC SMFxxxxx parameters will be the values in effect when the job was read. 
Modifications for these parameters are ignored during a warm start. The value 
for the SID SMFxxxxx parameter will be the value in effect when the job was read 
for record types 4 and 5 only. 
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Parameter 


Meaning and Use 


Value Range 


Default Value 


BUF <wm ) 
I nnnn ) 


This parameter is required unless MAN=NONE is specified. It 
indicates the SMF buffer size. (SMF buffer size requirements 
are discussed in the chapter "System Requirements and 
Considerations.") 
Notes: 

1 . Specify a BUF value that is a multiple of 8 bytes (double 
word); otherwise, SMF rounds the value to the next lower 
multiple of 8 bytes. 

2. Before reducing the buffer size specified in the previous 
IPL, dump the SMF data set; otherwise the data sets 
cannot be dumped. 


400 to 8,192 


None (Operator is 
prompted if BUF value is 
needed.) 


DSV=| J \ 
(3) 


This optional parameter specifies whether data set information 
and/or direct access volume information is to be collected 
by SMF. 

suppresses both data set information and direct access 
volume information. 

1 generates direct access volume information and suppresses 
data set information. 

2 generates data set information and suppresses direct 
access volume information. 

3 generates both data set information and direct access 
volume information. 

Note: If OPT=1 and either DSV=2 or DSV=3 is specified, 
SMF converts OPT=1 into OPT=2 and issues a warning message. 


0,1, 2 or 3 





«HSN 


This optional parameter specifies whether SMF exits (except 

IEFUSO, which is always taken when the output limit is 

reached) are to be taken. 

YES specif ies exits are to be taken. 

NO specifies exits are not to be taken. 

Note: If EXT=YES is specified, the exits taken will depend 

upon the data-collection parameter, OPT. If OPT=2, all 

exits defined for the system are taken. If OPT=1 , the step 

initiation exit, IEFUSI, and the step termination exit, 

IEFACTRT, are not taken. 


Not applicable 


YES 


JWT=/?/w? 


This is a required parameter that initially specifies the number 
of minutes a job is allowed to wait continuously. When the 
specified time limit has expired, the time limit exit, IEFUTL, 
is entered (if exits are to be taken). The limit value can be 
changed by IEFUTL. 


1-999 


10 


/NONE) 
MAN=<USER > 

Iall / 


This optional parameter specifies whether user and/or SMF 
records are to be written to the SMF data sets. You must 
specify MAN=ALL or MAN=USER if records are to be 
written to the SMF data sets. Unless MAN=NONE is 
specified, the BUF parameter is also required. 
NON E does not write user or SMF records to the SMF 

data sets, regardless of values specified for DSV, 

OPT, and REC parameters. 

USER writes only user records (types 128 through 255) 
to the SMF data sets. 

ALL writes both SMF and user records to the SMF data 
sets. All SMF records are created unless suppressed 
oy the DSV, OPT, or REC parameters. All SMF 
records that are created are written unless suppressed 
by user-written exit routines. 

Note: Even if MAN=USER is specified, the SMF record types 

2, 3, and 7 will still be written. 


Not applicable 


ALL 



( 



Figure 12. SMFxxxxx Parameters (Part 1 of 2) 
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Parameter 


Meaning and Use 


Value Range 


Default Value 


°"-{J£f 


This optional parameter specifies whether the SMFxxxxx 
parameters are to be presented on the console during initializa- 
tion for the operator's inspection and/or modification. (This 
parameter is ignored if it is entered from the console.) 
YES allows the operator to modify the SMFxxxxx parameters. 
NO does not allow the operator to modify the SMFxxxxx 
parameters. 


Not applicable 


NO 


™-\l\ 


This optional parameter specifies whether system and job informa- 
tion, as opposed to system, job, and job step information, is to 
be recorded. 

1 generates only system and job-related information (that is, 
record type 4 is suppressed and the step initiation exit, 
IEFUSI, and step termination exit, IEFACTRT, are not taken). 

2 generates system, job, and job step information. 

Note: If OPT=1 and DSV=2 or DSV=3 is specified, SMF converts 
OPT=1 into OPT=2 and issues a warning message. 


1 or 2 


2 


REC={§} 


This optional parameter specifies whether record type 1 7 will 
be written for temporary data sets. This parameter is not 
effective unless either DSV=2 or DSV=3 is specified. 
writes record type 1 7 for non-temporary data sets only. 
2 writes record type 1 7 for both temporary and non-temporary 
data sets. 


0or2 





SID=xxxx 


This is a required parameter that specifies the system and model 
on which SMF is active, provided the installation modifies the 
default value. 


Four alphameric 
and/or special 
characters 


155A 



Figure 12. SMFxxxxx Parameters (Part 2 of 2) 
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Selecting SMF Records Using SMFxxxxx Parameters 

Four SMFxxxxx parameters control the type of records to be written to the SMF 
data set: DSV, MAN, OPT, and REC. Figure 13 summarizes the use of these four 
parameters in selecting SMF records. 



( 



Parameter 


Value 


Meaning 


Effect on SMF Records 


DSV 





No information for data sets or direct 
access volumes. 


Suppresses record types 1 4, 1 5, 1 7, 1 8, 1 9, 62, 63, 64, 67, 68, 
and 69. 


1 


Direct access volume information. 1 


Generates record types 19 and 69; suppresses record types 14, 15, 
1 7, 1 8, 62, 63, 64, 67, and 68. 


2 


Data set information. 2 


Generates record types 14, 15, 17, 18, 62, 63, 64, 67, and 68; 
suppresses record types 19 and 69. 


3 


Data set and direct access 
information. 1,2 


Generates record types 14, 15, 17, 18, 19, 62, 63, 64, 67, 68, 
and 69. 


MAN 


NONE 


No records. 


The SMF data set is not used. 


USER 


User records. 


User record types 128 through 255 (and SMF record types 2, 3, 
and 7) can be written to the SMF data set. 


ALL 


Both user and SMF records. 


Record types through 255 can be written to the SMF data set. 


OPT 


1 


System and job information. 


Generates record types 0-3, 5-13, 20, 22, 43-45, 47-49, and 50; 
suppresses record type 4. 


2 


System, job, and job step information. 


Generates record type 4 and all the above record types. 


REC 





No information for temporary 
data sets. 


Generates record type 17 for non-temporary data sets only. 


2 


Temporary and non-temporary data 
set information. 


Generates record type 1 7 for both temporary and non-temporary 
data sets. 



1 Record type 21 is written to the SMF data set only when ESV=SMF is specified in the 
SCHEDULR macro instruction at SYSGEN time. 

2 lf OPT=1 and either DSV=2 or DSV=3 is specified, SMF converts OPT=1 
to OPT=2 and issues a warning message. 

Figure 13. Summary of the Use of SMFxxxxx Parameters to Select SMF Records 



User-written exit routines IEFU83 (SMF writer) and IEFACTRT (termination) 
can also control which records are to be written to the SMF data set. After 
inspecting an SMF record, these routines return a code to the system indicating 
whether the record is to be written to the SMF data set. 

Entering SMFxxxxx in SYS 1 .PARMLIB 

When you have determined which SMF parameters to use, place them in an 
SMFxxxxx member of SYS 1 .PARMLIB. The five alphameric characters represented 
by xxxxx are appended to SMF to identify your SMFxxxxx member. If you do not 
specify an SMFxxxxx member name, the default member SMFPRM00 is used. The 
parameters in SMFPRMOO are : 

OPT=2,EXT=YES,SID=155A,BUF=2000,JWT=10,OP|=YES,MAN=ALL 

For entering SMFxxxxx in SYS1 .PARMLIB when using automated system 
initialization (ASI), see the AUTO keyword in OS/VS1 Planning and Use Guide. 
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The SMFxxxxx parameters can be in any order; however, note the following 
coding restrictions: 

• Code each series of parameters in logical records no more than 80 bytes long. 

• Use columns 1-71 ; columns 72-80 are ignored. 

• Enter each parameter in the format : keyv/ord=value. 

• Do not use embedded blanks. 

• Separate consecutive parameters by commas. 

• Do not divide a parameter between consecutive records. 

• Indicate continuation by placing a comma after the last entry on a record, 
followed by a blank before column 72. 

To add the SMFxxxxx parameters as a member of SYS1 JPARMLIB, use the 
IEBUPDTE utility program. Figure 14 illustrates sample JCL for using IEBUPDTE 
to enter SMFPRM01 into SYS1.PARMLIB. To change the default member, 
SMFPRM00, or the installation -defined SMFxxxxx member, replace them with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 
program, see OS/VS1 Utilities. 



//ENTER JOB MSGLEVEL=1 

// EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSPRINTDD SYSOUT=A 

//SYSUT2 DD DSNAME=SYS1.PARMLIB,DISP=(OLD,KEEP) 1 

//SYSIN DD DATA 

./ ADD LIST=ALL.NAME=SMFPRM01,LEVEL=01,SOURCE=0 

(SMFPRM01 member) 

./ ENDUP 

/• 

1 To access SMFPRM00 on the distribution package before SYSGEN, use the 
S YS 1 . AP A R M L I B data set. 

Figure 14. Sample JCL for Entering SMFPRM01 into SYS 1 .P ARM LIB Using IEBUPDTE 



If OPI=YES was specified, the operator can modify the SMFxxxxx parameter 
values from the console during system initialization. If parameter errors occur, the 
operator will be prompted for correct parameters regardless of the value specified 
for OPI. 



Defining the Use of SMF 39 



i 



40 OS/VS1 System Management Facilities (SMF) 



User-Written Exit Routines 



SMF has exits in the control program that can link to user-written routines for 
monitoring jobs or job steps at various points in their processing cycles. An 
installation can use any or all of the SMF exits by including user-written exit 
routines in SYS1 .AOS00 before SYSGEN or in SYS1 .LINKLIB and 
SYS1 .NUCLEUS after SYSGEN. SMF automatically provides dummy routines for 
all unused exits. (For detailed information on adding user-written exit routines, 
see "Including Exit Routines in the Operating System" in the chapter "System 
Requirements and Considerations".) 



Planning Exit Routines 



This section introduces the SMF exits. It briefly describes when each exit is called, 
the parameters passed to it, and the return codes required from it. 

Exit Routines and Their Characteristics 

SMF supplies nine exits, which can link to user-written exit routines, as follows: 

• The input stream validation exit (IEFUIV) receives control from the input stream 
control routine for each job in the input stream. A return code from this exit 
indicates whether a job is to be accepted for processing. 

• The job validation exit (IEFUJV) receives control from job management before 
each job control statement (or cataloged procedure) in the input stream is 
interpreted. This exit also receives control again after all the JCL is interpreted. 
It is not taken for JCL comment statements. A return code from this exit 
indicates whether processing of the job is to be continued. 

• The job initiation exit (IEFUJI) receives control from the initiator before a job 
on the input queue is selected for initiation. A return code from this exit 
indicates whether the job is to be started or canceled. 

• The step initiation exit (IEFUSI) receives control from the initiator before each 
job step is started (prior to allocation). A return code from this exit indicates 
whether the job step is to be started or the job is to be canceled. 

• The time limit exit (IEFUTL) receives control from the timer interruption handler 
when one of the following time limits expires: the job CPU time limit (from the 
JOB statement); the step CPU time limit (from the EXEC statement or the 
default from the reader procedure); or the continuous wait time limit for the 

job (from the SMFxxxxx JWT parameter). A return code from this exit indicates 
whether the job step is to be terminated or processing is to be continued with a 
new time limit. 

• The SYSOUT limit exit (IEFUSO) receives control from JES when the number of 
records written to a SYSOUT data set exceeds the output limit for that data set. 
A return code from this exit indicates whether the job is to be terminated or 
processing is to be continued using a new limit. 
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The SMF record exit (IEFU83) receives control from the SVC 83 routine before 
each record is written to the SMF data set. A return code from this exit indicates 
whether the current SMF record is to be suppressed. 

The termination exit (IEFACTRT) receives control from the terminator on the 
normal or abnormal termination of each job step and job. When SMF=BASIC is 
specified, this exit also receives control at the beginning of allocation. A return 
code from this exit indicates whether the job is to be continued (for job steps 
only) or terminated, and whether the SMF termination records are to be written 
to the SMF data set (for SMF=FULL only). 

The job purge exit (IEFUJP) receives control from the SYSOUT writer routine 
when a job is ready to be purged from the system (that is, after the job has 
terminated and all SYSOUT output that pertains to the job has been written). 
This exit does not return a code to the control program. 



< 



Figures 15 and 16 summarize when each SMF exit is called, the modules that call 
each user- written exit routine, the information passed to each exit (in addition to the 
common exit parameters, described in Figure 18), and the return from each exit 
to the control program. Figure 15 summarizes this information for the exits 
available when SMF=BASIC is specified; Figure 16 summarizes it for the exits 
available when SMF=FULL is specified. 



Module: 


At: 


Interfaces 
With: 


For User 
Exit: 


Parameters Passed: 


Type of Return: 


IEFSMPUT 


Output Limit Expiration 


IEFSMFSO 


IEFUSO 


DCB address. 


Continue with new limit 
or cancel. 


IEFSD21Q 


Allocation 


IEFACTLK 


IEFACTRT 


Job step name, 
programmer name, job 
CPU time, job accounting 
fields, step CPU time, 
step accounting fields, 
completion code. 


Continue or cancel. 


IEFSD31Q 


Job Termination 


IEFACTLK 


IEFACTRT 


IEFZGST2 


Step Termination 


IEFACTLK 


IEFACTRT 


IEFOSC05 


Job Purge 


directly 


IEFUJP 


Programmer name, job 
CPU time, job 
accounting fields. 


None. 



Figure 15. Exit Routine Characteristics When SMF=B ASIC 



42 OS/VS 1 System Management Facilities (SMF) 



Module: 


At: 


Interfaces 
With: 


For User 
Exit: 


Parameters Passed: 


Type of Return: 


IEFVMB 


JES Reader 


directly 


IEFUIV 


JOB statement image. 


Continue or cancel. 


IEFVHH 


Interpretation 


directly 


IEFUJV 


JCL statement image, type of JCL 
statement. 


Continue or cancel. 


IEFVHEB 


I nterpretation 


directly 


IEFUJV 


IEFSD162 


Job Initiation 


IEFSMFIE 


IEFUJI 


Programmer name, job priority, 
job accounting fields. 


Continue or cancel. 


IEFSD162 


Step Initiation 


IEFSMFIE 


IEFUSI 


Job step name, program name, 
step accounting fields. 


Continue or cancel. 


IEATLEXT 


Timer 
Expiration 


directly 


IEFUTL 


None. 


Continue with new time limit or 
cancel. 


IEFSMPUT 


Output Limit 
Expiration 


IEFSMFSO 


IEFUSO 


DCB address. 


Continue with new limit or cancel. 


IEESMF8C 


SMF Buffer 
Time 


directly 


IEFU83 


SMF record to be written. 


Write or do not write record to SMF 
data set. 


IEFSD31Q 


Job 
Termination 


IEFSMFLK 


IEFACTRT 


Job step name, programmer name, 
job CPU time, job accounting 
fields, step CPU time, step 
accounting fields, completion code, 
SMF termination record. 


Continue or cancel; write or do not 
write record to SMF data set. 


IEFZGST2 


Step 
Termination 


IEFSMFLK 


IEFACTRT 


IFOSC05 


Job Purge 


directly 


IEFUJP 


Programmer name, job CPU time, 
job accounting fields. 


None. 



Figure 16. Exit Routine Characteristics When SMF=FULL 



Sample Exit Routines in SYS1.ASAMPLIB 

Sample assembler language exit routines for some SMF exits are provided in the 
member SMFEXITS of SYS1 .ASAMPLIB. Figure 1 7 shows sample JCL for 
obtaining a listing of these sample routines. 



//PRINT 


JOB 


II 


EXEC 


//SYSPRINT 


DD 


//SYSUT1 


DD 


II 




//SYSUT2 


DD 


//SYS IN 


DD 




PRINT 



MSGLEVEL=1 

PGM=IEBPTPCH 

SYSOUT=A 

DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 

UNIT=xxxx,VOLUME=SER=xxxxxx 1 

SYSOUT=A 



TYPORG=PO,MAXNAME=1,MAXFLDS=1 
MEMBER NAME=SMFEXITS 
RECORD FIELD=(80) 
/• 

1 The volume and unit parameters depend upon your installation's request. 
Figure 17. Sample JCL for Obtaining a Listing of Sample Exit Routines 

A summary of the sample exit routines in SYS1 .ASAMPLIB follows: 

• IEFUIV — No sample provided. 

• IEFUJV — Sample routine checks the validity of a continued JOB statement 

and of values supplied for REGION, PRTY, TIME, and accounting 
parameters in the JOB statement. The routine uses characters 
from the account number to index a table that contains allowable 
values for these parameters. If any value is invalid, the sample 
IEFUJV routine terminates the job. 
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• IEFUJI — Sample routine determines how long a job has been on the input 

job queue before it is initiated. It then writes this value and the 
job priority to the SMF data set as a user record. 

• IEFUSI — No sample provided. 

• IEFUTL — Sample routine terminates a job if either the job CPU time limit or 

the job step CPU time limit has been exceeded. If the continuous 
wait time limit for the job has been exceeded, the routine extends 
the limit twice; on the third entry for exceeding the continuous 
wait time limit, it cancels the job. Each time the routine is 
entered for exceeding the continuous wait time limit, it writes a 
record describing the action taken to the SMF data set. 

• IEFUSO — No sample provided. 

• IEFU83 — Sample routine determines whether the record to be written is an 

IPL record. If it is, the routine writes to the operator with a reply 
request for the record types to be written. If the record is not an 
IPL record, the return code depends upon the records currently 
requested. 

The sample IEFU83 routine has a special macro definition for 
"write to operator with reply" so that output normally directed to 
the operator is suppressed and a standard reply is assumed for 
testing with the TESTEXIT procedure. Remove this macro 
definition if you want the message printed at the console. The 
sample routine also has special macro definitions for "write to 
operator" and "wait", which generate no-op instructions. 

• IEFACTRT— Sample routine changes the SMF job termination and job step 

termination records (types 4 and 5) to user records, and attempts 
to write them to the SMF data set. If the data set is full, the 
routine writes a message to the console indicating that SMF 
records are being lost. At job termination, the routine writes a 
record containing the job name, programmer's name, and account 
number to the SYSOUT device. 



( 



• IEFUJP 



No sample provided. 



Writing Exit Routines 



This section describes: 

• Exit routine restrictions and facilities, including information on communication 
among user-written exit routines; the common parameters passed to all routines; 
the SMFWTM macro instruction, which is used to write records to the SMF data 
set; and the IFASMFR macro instruction, which is used to symbolically address 
fields in the SMF records. 

• Exit routines, including a full description of the parameters passed to each 
routine and the required return codes. 
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Exit Routine Restrictions 

This section describes only the restrictions and conditions common to most user- 
written exit routines. For those restrictions and conditions that involve only one or 
two exit routines, see the specific routine(s) later in this chapter. 

Before writing an exit routine, note the following user-written exit routine 
restrictions and conditions: 

• All user-written exit routines should be reenterable because the link-edit attributes 
of the load modules are subject to change from release to release. The exit 
routines IEFUTL and IEFU83, and any other routines that become resident, must 
be reenterable. 

• All user-written exit routines receive control via a BALR instruction. The routines 
must save registers when they receive control and restore registers when they 
return control to the control program. Register 13 contains the address of the 
register save area; register 14 contains the return address; and register 15 contains 
the entry point address. 

• All user-written exit routines receive control in storage protection key 0. 

• All user-written exit routines receive control with the system enabled for 
interrupts. 

• No user-written exit routines except IEFACTRT can write to the system output 
message data set. 

• Do not allocate installation-defined data sets to SYSOUT. To write to 
installation-defined data sets, define the data sets as follows: 

— A data set used by the IEFUIV exit routine requires a DD statement in the 
reader cataloged procedure. 

— A data set used by the exit routines IEFUJV, IEFUJI, IEFUSI, and IEFACTRT 
requires a DD statement in the initiator cataloged procedure. However, a job 
scheduled by the START command does not run in the initiator environment; 
it runs as if an initiator had not been started in the partition. Such a job does 
not have access to the initiator TIOT and thus cannot access user-defined data 
sets for that job's accounting. 

— A data set used by the IEFUJP exit routine requires a DD statement in the 
writer cataloged procedure. 

User-written exit routines IEFUTL, IEFUSO, and IEFU83 cannot write to 
installation-defined data sets. 

VSAM data sets are not supported for SMF exits from the system reader, writer, 
RT AM, or VTAM. 

• If you plan to use the TESTEXIT procedure for testing user-written exit routines, 
see "TESTEXIT Exit Routine Requirements" in the chapter "Testing Exit 
Routines." 

• If you plan to use the IBM OS/VS Sort/Merge Program Product, do not create 
user records smaller than the minimum length required by the program. (When 
using tape work devices, the minimum length this program can sort is 18 bytes. 
Otherwise, the minimum is one byte.) 
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Exit Routine Facilities g 

This section describes the facilities common to most user-written exit routines. For 
more information on the facilities that are particular to a specific exit routine, see 
that routine later in this chapter. 

Common Exit Parameter Area 

When a user-written exit routine receives control, register 1 points to a list of four- 
byte addresses. The first entry in this iist is common to aii exit routines except 
IEFU83. The first entry points to a parameter area that is 124 bytes long. 

Figure 1 8 describes the format of the common exit parameter area. Note that 
the fields in this parameter area are filled chronologically; therefore, not all fields 
are meaningful for all user-written exit routines. 
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Displacement 


Fielc 


from Pointer 


Size 





8 


8 


4 


12 


4 


16 


4 


20 


8 


28 


1 


29 


1 



Data 

Format 

EBCDIC 

binary 

packed 

EBCDIC 
EBCDIC 

binary 
binary 



Description 

Job name 

Time, in hundredths of a second, reader recognized the JOB card for this job 

Date reader recognized the JOB card for the job, in the form 00YYDDDF 

where F is the sign 
System identification (taken from SID parameter 1 ) 
User identification. Refer to description of record type 6 for special usage. This 

field is initialized to EBCDIC blanks when each job is read 2 
Number of the step being processed 
Indicator of the SMF options selected by the user. 



Option Selected When Set 

System and job accounting (OPT=1 ) 

System, job, and step accounting (OPT=2) 

User exits will be taken "(EXT=YES) 

Data set accounting (DSV=2 or 3) 

Volume accounting (DSV=1 or 3) 

Reserved 

Type'17 records will be written for temporary data sets (REC=2) 

Reserved 



30 


2 


binary 


32 


4 


binary 


36 


4 


binary 


40 


4 


binary 


44 


1 


binary 


45 


1 


binary 


46 


1 


EBCDIC 


47 


1 


EBCDIC 


48 


4 


binary 


52 


4 


binary 


56 


4 


binary 


60 


4 


binary 


64 


4 


binary 


68 


4 


binary 


72 


44 


binary 


116 


8 


EBCDIC 



Bit 



1 

2 

3 

4 

5 

6 

7 

Reserved 

User-communication field. This field is intended for communication among user 

exit routines. It is initialized to zeros when a reader is started 2 

Real time in reader, in hundredths of a second 5 

Number of cards read 5 

Job priority 

Reserved 

Job class 

Reserved 

Real time to print, in hundredths of a second 3 

Number of SYSOUT lines printed 3 - 4 

Real time to punch, in hundredths of a second 3 

Number of SYSOUT lines punched 3 

Real time for tape, in hundredths of a second 3 

Number of SYSOUT lines written to tape 3 

Reserved 3 

RTAM user identification 



1 Modifications for the SID parameter are ignored during a warm start IPL for SMF record types 4 and 5. 
2 These fields are provided for user modification. 

These fields are filled in at writer job purge time, and are valid only to the IEFUJP exit routine. 
4 This field includes job-related lines if the JOBLOG=YES parameter is specified in the JES macro instruction at SYSGEN. 
5 This does not include time or records read from associated data sets. 



Figure 18. Common Exit Parameter Area 



Communicating between Exit Routines 

User-written exit routines can communicate with each other in two ways: by using 
the user-communication field or by using the user-identification field. Both of these 
fields are contained in the common exit parameter area, which is passed to all user- 
written exit routines except IEFU83. 

All exit routines (except IEFU83) that are executing within the same job can 
communicate via the user-communication field (displacement 32 in Figure 18) and 
the user-identification field (displacement 20 in Figure 18). The IEFUIV exit 
routine is the only routine that can communicate between different jobs; it must 
use the user-communication field to do so. 
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Note: The user-communication field is initialized to zeros each time a reader is 
started; the user-identification field is initialized to EBCDIC blanks each time a job 
is read. Neither of these fields is maintained if the system is restarted. 



i 



Obtaining Additional Work Areas 

Any user-written exit routine can obtain an additional work area by issuing a 
GETMAIN macro instruction that specifies an appropriate subpool. Figure 19 shows 
the subpools (and their characteristics) that are required to obtain additional work 
areas. Be sure to consider the storage required by an additional work area when 
estimating the sizes of the system queue area and/or the partition queue area. 



Subpool 
Number 


Area in Storage 


Storage Attributes 


241 


System Queue Area 


Explicitly freed, by issuing a FREEMAIN macro 
instruction. 


253 


Partition Queue Area 


Automatically freed at end of task. 


254 


Partition Queue Area 


Automatically freed at end of step. 


255 


Partition Queue Area 


Explicitly freed, by issuing a FREEMAIN macro 
instruction. The area must be freed while the job 
is running in the same partition from which the 
area was gotten. 



Figure 19. Required Subpools for Obtaining Additional Work Areas 

If desired, you can place the address of the work area in the user-communication 
field. However, be aware that the address will be destroyed if the field is 
re-initialized to zero because a new reader was started. 

Using the SMFWTM Macro to Write Records 

Use the SMFWTM macro instruction in any user-written exit routine except IEFU83 
to write records to the SMF data set. The SMFWTM macro is written in assembler 
language and is supplied on SYS1 .MACLIB. Its format is: 

[label] SMFWTM j record address \ (r) \ 

where: 

record address 

is the symbolic address of the record to be written. 

(r) 

is a register containing the address of the record to be written. The value 
for (r) can be either the absolute register number or a symbol for the 
register. In either case, you must code the parentheses, for example, (2) or 
(REG2). 

Record types 128 through 255 are available for user-written records. When using 
the SMFWTM macro instruction to write user records, you must include the standard 
SMF record header and a record descriptor word (RDW) for each record. (For a 
description of the standard SMF record header, see the chapter "SMF Records" in 
this book. For a description of the RDW, see OS/VS Data Management Services 
Guide.) 
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Record types through 127 are SMF-formatted records. For all SMF-formatted 
records except types 4 and 5, you must supply only the record type field in the 
standard SMF record header (offset 1). The SMFWTM macro supplies the 
remaining header information. 

The SMFWTM macro instruction returns a code in register 15 that indicates the 
record's status, as follows: 

• indicates the record was written without error. 

• 4 indicates the record was truncated because it would not completely fit in an 

empty SMF data set. 

• 8 indicates the record was not written because the length specified in the RDW 

was less than five bytes. 

• 12 indicates the record was not written because the user-written exit routine was 

not authorized to write to the SMF data set. 

• 16 indicates the record was not written because (1) the MAN=NONE parameter 

suppressed the writing of records to the SMF data set, or (2) the writing of 
records was allowed but the SMF data set was full. (If the SMF data set is 
full, the operator must dump it before additional SMF records can be written. 
See "Dumping the SMF Data Sets" in the chapter "System Requirements and 
Considerations" for the procedure for executing the SMF dump program.) 

• 20 indicates the record was not written because the user-written IEFU83 exit 

routine suppressed the record. 

The exit routine which issues the SMFWTM macro instruction must be operating 
in key when it issues the macro instruction. (Refer to the description of the 
MODESET macro instruction in the OS/VS1 Planning and Use Guide.) 

Using the IFASMFR Macro to Address SMF Record Fields 

Use the IFASMFR macro instruction in user-written exit routines (or in any problem 
program application) to symbolically address SMF record fields. The macro is 
written in assembler language and is supplied on SYS1 .AMODGEN. (Depending on 
your installation's requirements, you may want to copy the IFASMFR macro from 
SYS 1 .AMODGEN into your own macro library or SYS1 .MACLIB.) 

The format of the IFASMFR macro is: 
[label] IFASMFR n 

where: 
n 

is the record type to be defined. You must specify at least one record type 
with the macro; if more than one record type is specified, you must enclose 
the record types in parentheses and separate them by commas. The values for 
n can be: 0-15, 17-22, 43-45, 47-51, 62-64, 67, 68 and 69. 

Notes: 

1 . The "Name" column in all the SMF record formats (see the chapter "SMF 
Records") contains the symbolic addresses defined by the IFASMFR macro 
instruction. 

2. Do not specify both record type 14 and record type 15 in the same program. 
Because these records are identical, whenever record type 15 is specified in the 
IFASMFR macro, record type 14 is defined. 

3. If you do not want the IFASMFR macro to use part of the problem program's 
storage, then supply a CSECT or DSECT statement ahead of the macro 
instruction. 
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IEFUIV - Input Stream Validation Exit 

IEFUIV receives control from the input stream validation control routine every 
time a new job is encountered in the input stream. A user-written IEFUIV exit 
routine can verify that the JOB statement is correct and acceptable for processing. 
It can also modify any of the operand fields in the JOB statement. 

Notes: 

1. To record the jobs that were not accepted by IEFUIV on the SMF data set, use 
the IEFUIV exit routine. To use mstaiiation-defined data sets with this exit 
routine, you must define them with a DD statement in the reader cataloged 
procedure. 

2. A user-written IEFUIV exit routine can use the user-communication field to 
communicate between different jobs. Data placed in this field by IEFUIV will 
become part of each job, will be accessible by all exit routines entered during 
each job (except IEFU83), and will be the same the next time IEFUIV is entered 
unless a new reader is started. (When a new reader is started, the user-communica- 
tion field is initialized to zeros.) 

3. When modifying a JOB statement, do not include any additional continuation 
cards. Also, when adding or modifying operand fields, begin the first operand 
field in the same place that it was before any additions or modifications were 
made. 

Parameters 

At entry to the IEFUIV exit routine, register 1 points to a list of four-byte 
addresses, as follows: 

1. The address of the common exit parameter area. (See Figure 18.) 

2. The address of an 80-character JOB statement image. 

Return Codes 

Before the IEFUIV exit routine returns to the control program, it must place a 
return code in register 15, as follows: 

indicates the job is acceptable for processing. 
4 indicates the job is not acceptable for processing. 

IEFU JV - Job Validation Exit 

IEFUJV receives control from job management before each job control statement 
(or cataloged procedure) in the input stream is interpreted. This exit routine also 
receives control again after all of the JCL is interpreted. It is not taken for comment 
statements. A user-written IEFUJV exit routine can do any or all of the following: 

• Validate any account fields included in the JOB and EXEC statements by 
comparison with a standard list. 

• Validate or assign job priority. 

• Validate or assign the REGION request. 

• Validate or assign job time and job step time parameters. 



I 
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• Control output stream data by using the OUTLIM or SPACE parameters. 

• Check for authorization to use data sets. 

• Create user-written records. 

• Assign the user identification to be included in the SMF termination records 
(types 4 and 5) and the SMF SYSOUT record (type 6). 

Notes: 

1 . If a cataloged procedure is used, it is expanded before the IEFUJV exit routine 
receives control; the sequence of statements is JOB, EXEC PROC=. . . , 
EXEC PGM=. . . , followed by the other statements of the procedure. Override 
statements immediately precede the statements being overriden. Note, however, 
that symbolic parameters are resolved after the IEFUJV exit routine is taken. 

2. When modifying a JCL statement, do not include additional JCL statements or 
continuation cards. Also, when adding or modifying operand fields, begin the 
first operand field in the same place that it was before any additions or 
modifications were made. 

3. Depending upon the processing to be performed, it may be more efficient to 
check JOB and EXEC statement accounting fields in the IEFUJI exit routine and 
the first IEFUSI exit routine, respectively. The accounting fields are passed as 
parameters to IEFUJI and IEFUSI, making a statement scan routine unnecessary. 
Either of these exit routines can assign user identification, and the IEFACTRT 
exit routine can write messages to the system output message data set. 

4. At job step or job termination, use the termination indicators in record types 4 
and 5, respectively, to determine whether IEFUJV canceled the job. 

5. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 

6. IEFUJV receives control when a job is reinterpreted for restart. IEFUIV 
does not receive control because the input stream is not reread. 

7. In SMF SYSOUT records (type 6) the user identification appears only in the last 
type 6 record for that particular output class for that job. 

Parameters 

At entry to the IEFUJV exit routine, register 1 points to a list of four-byte addresses, 
as follows: 

1. The address of the common exit parameter area. (See Figure 18.) 

2. The address of an 80-character JCL statement image (in EBCDIC). (JCL 
statements are identical to those listed in the SYSOUT data set; control 
statements containing only comments, however, are not made available to this 
exit routine.) 

3. The address of a one-byte area that indicates the type of JCL statement being 
passed to this exit routine. The indicator will be a binary value, as follows: 

indicates a null statement. 

1 indicates a JOB statement. 

2 indicates an EXEC statement. 
4 indicates a DD statement. 

8 indicates a PROC statement (for symbolic parameter definition). 
1 6 indicates all JCL images have been passed to IEFUJV. 
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Return Codes 

Before the IEFUJV exit routine returns to the control program, it must place a 
return code in register 15, as follows: 

indicates job processing should be continued. 

4 indicates job processing should be canceled. 

IEFUJI - Job Initiation Exit 

IEFUJI receives control from the initiator when a job on the input queue is 
selected for initiation. A user-written IEFUJI exit routine can validate job 
accounting information or write to a user data set. It can also determine how 
long a job was on the input job queue before it was selected for initiation. 

Notes: 

1. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 20 shows the format 
of the JOB statement accounting information that is available to IEFUJI. 

Offsets 
Dec. Hex. Length Format Description 

1 binary Number of accounting fields. 

1 1 variable EBCDIC Accounting fields. Each entry for an accounting 

field contains the length of the field (one byte, 
binary) followed by the field (EBCDIC). A zero 
indicates an omitted field. 

Figure 20. Format of Accounting Information Passed to IEFUJI, IEFUSI, IEFACTRT, and 
IEFUJP 

2. At job step or job termination, use the termination indicators in record types 4 
and 5, respectively, to determine whether IEFUJI canceled the job. 

3. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 

Parameters 

At entry to the IEFUJI exit routine, register 1 points to a list of four-byte addresses 
as follows: 

1 . The address of the common exit parameter area. (See Figure 18.) 

2. The address of a 20-byte area containing the programmer's name (in EBCDIC) 
from the JOB statement. This area is aligned left and padded with blanks if 
necessary. 

3. The address of a one-byte area indicating the requested job priority. 

4. The address of an area containing the accounting information from the JOB 
statement. (See Figure 20.) 
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Return Codes 

Before the IEFUJI exit routine returns control to the control program, it must place 
a return code in register 15, as follows: 

indicates job processing should be continued. 
4 indicates job processing should be canceled. 

IEFUSI - Step Initiation Exit 

IEFUSI receives control from the initiator before each job step is started (prior to 
allocation). A user-written IEFUSI exit routine can validate job step accounting 
information or write to a user data set. 

Notes: 

1 . If OPT=l was specified in the SMFxxxxx member or entered from the console 
at IPL time, this exit routine is not taken. 

2. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 20 shows the format 
of the EXEC statement accounting information that is available to IEFUSI. 

3. At job or job step termination, use the termination indicators in record types 4 
and 5, respectively, to determine whether IEFUSI canceled the job. 

4. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 

Parameters 

At entry to the IEFUSI exit routine, register 1 points to a list of four-byte addresses, 
as follows: 

1 . The address of the common exit parameter area. (See Figure 18.) 

2. The address of an eight-byte area containing the job step name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. 

3. The address of an eight-byte area containing the program name (in EBCDIC) from 
the EXEC statement. This area is aligned left and padded with blanks if 
necessary. 

4. The address of an area containing the accounting information from the EXEC 
statement. (See Figure 20.) 

Return Codes 

Before the IEFUSI exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

indicates job processing should be continued. 
4 indicates job processing should be canceled. 
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IEFUTL - Time Limit Exit 

IEFUTL receives control from the timer interruption handler when one of the ^ 

following time limits expire: 

• The job CPU time limit (from the JOB statement). 

• The step CPU time limit (from the EXEC statement or the default from the 
reader procedure). 

• The continuous wait time limit for the job (from the SMFxxxxx JWT parameter). 

A user-written IEFUTL exit routine can control and record time expirations. 
For example, it can inform the operator that a job has exceeded its continuous wait 
time limit and request a reply to either cancel the job or extend the time limit. 

Notes: 

1 . IEFUTL must be reenterable. 

2. A system interlock occurs anytime IEFUTL enqueues on a resource already 
enqueued on by the job step task or any of its subtasks. (More specifically, the 
initiator abnormally terminates if IEFUTL enqueues on such a resource because 
the asynchronous exit interface routine sets a "step must complete" status before 
IEFUTL receives control.) The enqueue can come from within SVCs; for example, 
it can come from the SMFWTM macro instruction. To minimize the chances of 

an interlock, issue an ENQ macro of the following format before issuing an 
SMFWTM macro instruction: 



ENQ(SYSIEFSD,BUF,mode,3,SYSTEM),RET=TEST 

(Resource names used by system tasks are listed in the OS/VS1 Programmer's 
Reference Digest.) If a return code other than is returned from this test ENQ, 
consider the resource unavailable. If IEFUTL does not run disabled, the status 
of the resource could change during the time between the test ENQ and the 
actual ENQ. (Refer to OS/VS1 Supervisor Services and Macro Instructions for 
detailed information on return codes from the ENQ macro instruction.) 

3. The IEFUTL exit routine cannot access installation-defined data sets. It can 
access the SMF data set or write a message to the console; however, in doing so, 
a system interlock could occur. (See Note 2.) 

4. If a job time limit is not specified on the JOB statement, the time limit for each 
job step is the value specified for the TIME= parameter on the EXEC statement, 
or the default value from the reader procedure. 

If a job time limit is specified on the JOB statement, the time limit for each job 
step is the remaining job time or the job step time limit (from the TIME= 
parameter or the reader procedure default), whichever is smaller. 

5. If TIME=1440 is specified on the JOB statement, all timing for the job is 
eliminated. If TIME=1440 is specified on the EXEC statement and a job time 
limit is not specified on the JOB statement, all timing for the job step is 
eliminated. 

6. You can extend execution time only within a step; each extension resets the 
limit for the wait currently in process. When the step with the time extension 
completes, the next step will never be started if the total job CPU time used is 
greater than the job CPU time limit including the extension. 

7. In a VS1 system with extended timer support, the smallest time extension 
granted is 2^0 microseconds or 1 .048576 seconds. 
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Parameters 

At entry to the IEFUTL exit routine, register 1 points to the four-byte address of 
the common exit parameter area. (See Figure 18.) Register will have a binary 
value, as follows: 

indicates the job CPU time limit expired. 

4 indicates the step CPU time limit expired. 

8 indicates the continuous wait time limit for the job expired. 

Return Codes 

Before the IEFUTL exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

indicates job processing is to be canceled. 

4 indicates job processing is to be continued with a time extension (in timer units). 

You must place the time extension in register 1 ; you can determine the number 
of timer units by the algorithm : 

1 second = 38400 timer units. 

IEFUSO - SYSOUT Limit Exit 

IEFUSO receives control from JES when the number of records written to an output 
data set exceeds the output limit for that data set. Unless an IEFUSO exit routine 
is supplied, jobs are canceled when the output limit is reached. To specify the output 
limit, use the JOUTLIM parameter of the JES macro instruction at SYSGEN time. 
Use the OUTLIM parameter on the DD statement defining the output data set to 
override the JOUTLIM value. Note that the OUTLIM parameter limits only output 
to spooled data sets; it does not apply to direct data sets. This parameter is 
described in OS/VS1 JCL Reference. 

Notes: 

1 . The IEFUSO exit routine is not controlled by the SMFxxxxx EXT parameter; 

if SMF=BASIC or SMF=FULL was specified in the SCHEDULR macro instruction 
at SYSGEN time, and an IEFUSO exit routine was supplied , the IEFUSO routine 
will always receive control when the output limit is reached. Otherwise, the job 
is canceled. 

2. If IEFUSO indicates that the output limit is to be increased (register 15=4) but 
you do not increase the limit (register 1=0), the exit routine will receive control 
again when the next record is written to the output data set. 

3. The IEFUSO exit routine cannot access installation-defined data sets. 
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Parameters 

At entry to the IEFUSO exit routine, register 1 points to a list of four-byte 
addresses, as follows: 

1 . The address of the common exit parameter area. (See Figure 18.) 

2. The address of the DCB for the data set. 

Return Codes 

Before the IEFUSO exit routine returns control to the control program, it must 
place a return code in register 1 5, as follows: 

indicates job step processing is to be canceled. 

4 indicates job step processing is to be continued and the output limit is to be 
increased by the value placed in register 1 . 

IEFU83 - SMF Record Exit 

IEFU83 receives control from the SVC 83 routine before each record is written to 
the SMF data set. This exit routine is not taken for records whose writing has been 
suppressed either because of a system failure, or because of options selected at IPL 
time (see "Selecting SMF Records Using SMFxxxxx Parameters" in the chapter 
"Defining the Use of SMF"). A user-written IEFU83 exit routine can select the 
records to be written to the SMF data set or check the circumstances that caused 
SMF to generate a given record. An example of the latter is asking the operator the 
reason for an IPL when SMF generates an IPL record. (IEFU83 can also direct 
output to the console.) 

Notes: 

1. IEFU83 must be reenterable. 

2. The IEFU83 exit routine cannot access installation-defined data sets. Also, it 

cannot use the SMFWTM macro instruction to write to the SMF data set. 

3. If the installation does not plan to use record types 63 (VSAM Entry Defined) 
or 67 (VSAM Entry Deleted), you can use IEFU83 to suppress writing them to 
the SMF data set or to truncate them. 

4. The addresses of the user-communication and user-identification fields of the 
common exit parameter area are not passed to the IEFU83 exit routine. 

Parameters 

At entry to the IEFU83 exit routine, register 1 points to the four-byte address of 
the record descriptor word (RDW) of the SMF record to be written. 

Return Codes 

Before the IEFU83 exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

indicates the record is to be written to the SMF data set, 
4 indicates the record is not to be written to the SMF data set. 



( 
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IEFACTRT - Termination Exit 

IEFACTRT receives control from the terminator when each job or job step 
normally or abnormally terminates. If SMF=BASIC was specified in the 
SCHEDULR macro, IEFACTRT also receives control at the beginning of allocation. 
If OPT=l was specified in the SMFxxxxx member of SYS1 .PARMLIB or the 
operator entered OPT=l from the console at system initialization time, this exit 
routine receives control only at job termination. A user-written IEFACTRT exit 
routine can perform various functions that are unique to an installation's 
requirements. For example, it can change the SMF record types 4 and 5 to user 
records and write them to an installation-defined data set for further analysis. 

Notes: 

1 . IEFACTRT is the only exit routine, than can write to the system output message 
data set, and only by passing a message to module IEFYS. If a user-written 
IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine received control, and register 13 
must contain the address of an 18-word work area. Figure 21 shows the procedure 
to use when writing system output messages from IEFACTRT. Note that the 
maximum number of characters printed on one line is 132. 





• MVC 


36(4,1 2) ,MSGADDR 


MOVE MESSAGE ADDRESS AND 




MVC 


42(2,1 2) ,MSGLEN 


LENGTH TO SYSTEM TABLE 
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REG15,VIEFYS 
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ROUTINE 


MSGADDR 


DC 


A(MSG) 




MSG 


DC 


C 'message text' 




MSGLEN 


DC 


H'xx' 


MESSAGE LENGTH 1 


VIEFYS 


DC 


V(IEFYS) 





2 The message will be truncated to 132 characters if necessary. 
Figure 21. Writing System Output Messages from IEFACTRT 

2. IEFACTRT can direct output to the console or to the system output device. It 
can also write to the SMF data set or to an installation-defined data set. To use 
installation-defined data sets with this exit routine, you must define them with 
a DD statement in the initiator cataloged procedure. 

3. At job step or job termination, use the termination indicators in record types 4 
and 5, respectively, to determine whether IEFACTRT canceled the job. 

Parameters 

At entry to the IEFACTRT exit routine, register 1 points to a list of four-byte 
addresses, as follows: 

1 . The address of the common exit parameter area. If SMF=BASIC was specified 
at SYSGEN time, the address is that of the jobname. (See Figure 1 8.) 

2. The address of an eight-byte area containing the job step name (in EBCDIC). 
This area is aligned left and padded with blanks if necessary. At job termination, 
the address is zero. 

3. The address of a 20-byte area containing the programmer's name (in EBCDIC). 
This area is aligned left and padded with blanks if necessary. 
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4. The address of a four-byte area whose first three bytes contain the job CPU time 
in hundredths of a second (in binary), and whose last byte contains the number 
of accounting fields in the JOB statement (in binary). 

5. The address of an area that contains accounting information from the JOB 
statement. This area has the format described earlier in Figure 20, excluding 
the first field shown (the number of accounting fields). 

6. The address of a four-byte area whose first three bytes contain the step CPU time 
in hundredths of a second (in binary), and whose last byte contains the number 
of accounting fields in the EXEC statement (in binary). At job termination, the 
address is zero. 

7. The address of an area that contains accounting information from the EXEC 
statement. This area has the format described earlier in Figure 20, excluding the 
first field shown (the number of accounting fields). At job termination, the 
address is zero. 

8. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 1 
when the exit routine is entered, the job has been canceled; if the exit routine 
sets bit 7 to 1 , the job will be canceled. The second byte contains the number of 
the job step currently being processed. At job termination, the second byte 
contains the number of steps in the job. 

9. The address of a two-byte area containing the termination status (condition or 
completion code) of the job or job step. If SMF=BASIC was specified at 
SYSGEN time, this field does not exist. 

10. The address of an area containing a four-byte record descriptor word (RDW) 
immediately followed by the job step termination record (type 4) or the job 
termination record (type 5) to be written to the SMF data set. If SMF=BASIC 
was specified at SYSGEN time, this field does not exist. 

At entry to the IEFACTRT exit routine, register contains a binary code 
indicating the reason for entry, as follows: 

8 indicates job step allocation. 
12 indicates job step termination. 
16 indicates job termination. 

Return Codes 

Before the IEFACTRT exit routine returns control to the control program, it must 
place return codes in registers 1 and 15, as follows: 

• In register 1 (for SMF=FULL only): 

4 indicates the termination record is not to be written to the 

SMF data set. 

A value other than 4 indicates the termination record is to be written to the 
SMF data set. 

• In register 1 5 : 

4 indicates the remaining job steps are to be canceled. 

A value other than 4 indicates job processing is to be continued. 



< 
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IEFUJP - Job Purge Exit 

IEFUJP receives control from the SYSOUT writer routine when a job is ready to be 
purged from the system, that is, after a job has terminated and all the SYSOUT 
output that pertains to the job has been written. A user-written IEFUJP exit 
routine (and the SMFWTM macro instruction) can write additional data statistics 
found in the common exit parameter area to the SMF data set. (See Figure 18.) 

Note: To use installation-defined data sets with this exit routine, you must define 
them with a DD statement in the writer cataloged procedure. 

Parameters 

At entry to the IEFUJP exit routine, register 1 points to a list of four-byte addresses, 
as follows: 

1. The address of the common exit parameter area. (See Figure 18.) 

2. Reserved. 

3. The address of a 20-byte area containing the programmer's name (in EBCDIC). 
This area is aligned left and padded with blanks if necessary. 

4. The address of a four-byte area whose first three bytes contain the job CPU time 
in hundredths of a second (in binary) and whose last byte contains the number of 
accounting fields in the JOB statement (in binary). 

5. The address of an area that contains accounting information from the JOB 
statement. This area has the format described earlier in Figure 20, excluding the 
first field shown (the number of accounting fields). 

Return Codes 

IEFUJP does not return a code to the control program. 

Testing Exit Routines 

One method of testing user-written exit routines is by using the TESTEXIT 
procedure in SYS1 .ASAMPLIB. This procedure contains an assembler language 
source program (also named TESTEXIT) which attaches the data generator utility 
program (IEBDG) to create sample parameter lists. The source program then calls 
each user-written exit routine being tested, and passes the appropriate parameter 
list to it. Figure 22 illustrates the input/output and control flow of the TESTEXIT 
source program. 
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Data 

Generator 
Control 
Statements 



C 



JCL 



Diagnostic Messages 




SYSPRINT 



SMF Records 
^ ** 



MANX 



4 



Figure 22. TESTEXIT Input/Output and Control Flow 

Before using the TESTEXIT procedure: 

1. Fulfill the following user-written exit routine testing requirements: 

• Specify a user subpool (0-127) in all GETMAIN macro instructions included 
in the routines. 

• Provide a special SMFWTM macro instruction in all routines that use the macro. 

• Place the routines in a partitioned data set. 

2. Obtain the TESTEXIT procedure from SYS1.ASAMPLIB. 

3. Modify the procedure to meet the installation's testing requirements. 

TESTEXIT Exit Routine Requirements 

Before using the TESTEXIT procedure, fulfill the following exit routine 
requirements: 

• Specify a user subpool (0-127) in all GETMAIN macro instructions included in 
your routines. When testing is completed, specify one of the subpools shown in 
Figure 19 for the area used to communicate between exit routines. 
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Provide a special SMFWTM macro instruction in all exit routines that use the 
macro. The special macro definition writes to the TESTEXIT data set defined by 
the DD statement named MANX. (With the normal SMFWTM macro instruction, 
the data is written to SYS1 .MANX or SYS1 .MANY.) Using this macro definition, 
then, data is processed without accessing the system data on SYS1 .MANX or 
SYS1 .MANY. When testing is completed, remove the macro definition. Figure 
23 shows the SMFWTM macro instruction that is required for using the 
TESTEXIT procedure. 





MACRO 




&NAME 


SMFWTM 


&MSGAD 




AIF 


(T'&MSGAD EQ'0').E1 




AIF 


C&MSGAD'(1,1) EOT) .REGA 


&MAME 


LA 


1,&MSGAD 


.LIST 


CNOP 


0,4 




BAL 


15,*+8 




DC 


V(TSMFWTM) 




L 


15,0(15) 




BALR 


14,15 




MEXIT 




.REGA 


ANOP 




&NAME 


DS 


OH 




AIF 


C&MSGAD' EQ'(D').LIST 




LR 


1,&MSGAD(1) 




AGO 


.LIST 


.E1 


MIMOTE 
MEND 


4,'*** NO OPERAND SPECIFIED *** 



Figure 23. SMFWTM Macro Definition Required for Using TESTEXIT 

• Place the exit routines in a partitioned data set named EXITLIB. Figure 24 
shows sample JCL for entering the routines into EXITLIB. 
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//UPDTE JOB MSGLEVEL=1 £ 

II EXEC PGM=IEBUPDTE,PARM=NEW f 

//SYSUT2 DD DSNAME=EXITLIB,VOLUME=SER=231400, 

// UNIT=2314,SPACE=(TRK,(10,3,1)).DISP=(,KEEP), 

// DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD DATA 

./ ADD NAME=IEFUIV 

(IEFUIV object deck) 

./ ADD NAME=IEFUJV 

(IEFUJV object deck) 

./ ADD NAME=IEFUJI 

(IEFUJI object deck) 

./ ADD NAME=IEFUSI 

(IEFUSI object deck) 

./ ADD NAME=IEFUTL 

(IEFUTL object deck) 

./ ADD NAME=IEFUSO 

(IEFUSO object deck) 

./ ADD NAME=IEFU83 

(IEFU83 object deck) 

./ ADD NAME=IEFACTRT 

(I EFACTRT object deck) 

./ ADD NAME=IEFUJP 

(IEFUJP object deck) 

./ ENDUP 4 

'. ; % 

Figure 24. Sample JCL for Entering User-Written Exit Routines into EXITLIB 

Obtaining TESTEXIT from SYS1 .ASAMPLIB 

Figure 25 shows sample JCL for obtaining a punched deck of TESTEXIT from 
SYS 1. ASAMPLIB. 

//PUNCH JOB MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(0LD,KEEP), 

// UNIT=xxxx,VOLUME=SER=xxxxxx 1 

//SYSUT2 DD UNIT=2540-2 

//SYSIN DD 

PUNCH TYP0RG=P0,MAXNAME=1,MAXFLDS=1 

MEMBER NAME=TESTEXIT 

RECORD FIELD=(80) 
I* 
^■Jhe volume and unit parameters depend on your installation's request. 

Figure 25. Sample JCL for Obtaining a Punched Deck of TESTEXIT 
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Modifying the TESTEXIT Procedure 

Figure 26 shows sample JCL for executing the TESTEXIT procedure in an 
unmodified system. 

//TESTEXIT J0i MSGLEVEL=1 

//TEST EXEC ASMFCL 

//ASM .SYS IN DD 

(TESTEXIT Source Module) 

/* 

//LKED.SYSLMOD DD DSNAME=TESTLIB,VOLUME=SER=231400, 

// UNIT=2314,SPACE=(TRK,(5,2,D), 

// DISP=(NEW,KEEP) 

//LKED.EXITS DD DSNAME=EXITLIB,VOLUME=SER=231400, 

// UNIT=2314,DISP=OLD 

//LKED.SYSIN DD 

INCLUDE EXITS(IEFUIV,IEFUJV,IEFUJI,IEFUSI,IEFUTL,IEFUSO, 
IEFU83,IEFACTRT,IEFUJP) 

ENTRY TESTEXIT 

NAME TESTEXIT 

/* 

//DATAGEN JOB MSGLEVEL=1 

// EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSUT2 DD DSNAME=DGINPUT,UNIT=2314,DISP=(,KEEP), 

// VOLUME=SER=231400,SPACE=(TRK,(1 0,5,1)), 

// DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD DATA 

./ ADD NAME=UIV 

(IEBDG Control Statements for IEFUIV) 

./ ADD NAME=UJV 

(IEBDG Control Statements for IEFUJV) 

./ ADD NAME=UJI 

(IEBDG Control Statements for IE FUJI) 

./ ADD NAME=USI 

(IEBDG Control Statements for IEFUSI) 

./ ADD NAME=USO 

(IEBDG Control Statements for IEFUSO) 

./ ADD NAME=UTL 

(IEBDG Control Statements for IEFUTL) 

./ ADD NAME=U83 

(IEBDG Control Statements for IEFU83) 

./ ADD NAME=ACT 

(IEBDG Control Statements for IEFACTRT) 

./ ADD NAME=UJP 

(IEBDG Control Statements for IEFUJP) 

Figure 26. Sample JCL for Executing TESTEXIT (Part 1 of 2) 
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./ ENDUP 

/* 

//TESTING 

//JOBLIB 

II 

II 

II PARM='UIV= 

//INUIV 

II 

II 

//INUJV 

II 

II 

//INUJI 

II 

II 

//INUSI 

II 

II 

//INUSO 

// 

II 

//INUTL 

II 

II 

//INU83 

II 

II 

//IN ACT 

II 

II 

//INUJP 

II 

II 

//OUTUIV 

II 

II 

//OUTUJV 

II 

II 

//OUTUJI 

II 

II 

//OUTUSI 

II 

II 

//OUTUSO 

II 

II 

//OUTUTL 

II 

II 

//OUTU83 

II 

II 

//OUTACT 

// 

II 

//OUTUJP 

II 

II 

//MANX 

II 

II 

//SYSPRINT 

//DGPRINT 

//SYSABEND 

/* 



( 



JOB MSGLEVEL=1 

DD DSNAME=TESTLIB,VOLUME=SER=231400, 

UNIT=2314,DISP=(OLD,KEEP) 
EXEC PGM=TESTEXIT. 
3,UJV=25,UJI=8,USI=8,USO=5,UTL=5,U83==12,ACT=2,UJP=2' 
DD DSNAME=DGINPUT(UIV),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(UJV),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(UJI),DCB=(LRECL=80, 

BLKSIZE=400 f RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(USI),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT{USO),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(UTL),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(U83),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(ACT),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(UJP),DCB=(LRECL=80, 

BLKSIZE=400 / RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=UIV(OUT),UNIT=2314,DISP=(.PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=UJV(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400 ( RECFM=FB) 
DD DSNAME=UJI(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=USI(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10 / 5,1)),VOLUME=SER=231400 / 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=USO(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=UTL(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK / (10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=U83(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(1 0,5,1 )),VOLUME=SER=231400, 
DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
DD DSNAME=ACT(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=180,BLKSIZE=180,RECFM=FB) 
DD DSNAME=UJP(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
DD UNIT=2314,VOLUME=SER=231400,DSN=MANX, 

SPACE=(TRK,(3,1)),DISP=(NEW / KEEP), 
DCB=(BLKSIZE=200,LRECL=196) 

DD SYSOUT=A,DCB=(BLKSIZE=136,LRECL=132) 

DD SYSOUT=A 

DD SYSOUT=A 



Figure 26. Sample JCL for Executing TESTEXIT (Part 2 of 2) 
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A summary of the operations performed by the procedure shown in Figure 26 
is as follows: 

• The TESTEXIT job assembles the TESTEXIT source program (not illustrated in 
the figure) and link-edits it with the exit routines being tested. (Note that the 
exit routines must reside in EXITLIB, a partitioned data set.) 

• The DATAGEN job, using the IEBUPDTE utility program, creates a partitioned 
data set (DGINPUT) containing control statements for the IEBDG utility program, 
which will be attached by the TESTEXIT source program. 

• The TESTING job includes the execution of the TESTEXIT source program. 

Use the TESTEXIT procedure provided in SYS1.ASAMPLIB, without 
modification, to link-edit the sample exit routines in SYS1.ASAMPLIB, generate 
sample parameter lists, and test the sample exit routines. To adapt the TESTEXIT 
procedure to your installation's testing requirements, however, note the following 
modifications: 

• The TESTEXIT job shown in Figure 26 link-edits the TESTEXIT source program 
with the exit routines. You must substitute an INCLUDE control statement 
specifying the names of the exit routines being tested. 

• The DATAGEN job shown in Figure 26 creates a partitioned data set containing 
control statements that generate samples of standard parameter lists. You should 
omit control statements and their associated ADD statements for any exit 
routines not being tested. When testing for special conditions or required 
additional test parameters, you must make appropriate modifications and 
additions to the control statements. 

Note that you must supply control statements in such an order that the records 
subsequently generated by the IEBDG utility program will be grouped as complete 
parameter lists that conform in length and format to the exit parameters previously 
defined in this chapter. (Be sure to include the entry code passed to exits IEFUTL 
and IEFACTRT in register as a one-byte parameter at the end of the parameter 
lists for those exits.) For detailed information on the use of IEBDG control 
statements, see OS/VS1 Utilities. 

• The TESTING job shown in Figure 26 includes the execution of the TESTEXIT 
source program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
This parameter has the format: 

PARM='xxx=n/w , . . . ,xxx=nnn' 

where: 

is an exit routine identifier. 

nnn 

is the number of times an exit routine is to be tested (the maximum value is 

255). 
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The DD statements to be included depend upon the exit routines being tested. 
Figure 27 shows the exit-routine identifiers, specified on the EXEC statement, and 
the DD statements that you must include for each exit routine being tested. 



( 



Exit Routine 


Identifier 


DD Statements 


IEFUIV 


UIV 


INUIV,OUTUIV 


IEFUJV 


UJV 


INUJV.OUTUJV 


IEFUJI 


UJI 


INUJI,OUTUJI 


IEFUSI 


USI 


INUSI,OUTUSI 


IEFUTL 


UTL 


INUTL.OUTUTL 


IEFUSO 


USO 


INUSO,OUTUSO 


IEFU83 


U83 


INU83, OUTU83 


IEFACTRT 


ACT 


IN ACT, OUT ACT 


IEFUJP 


UJP 


INUJP, OUTUJP 


Any 




MANX, SYSPRINT, DGPRINT, SYSABEND 



Figure 27. Parameters and DD Statements for Executing TESTEXIT 

Note that you must include DD statements for any other data sets used by the exit 
routines in the JCL for the TESTEXIT procedure. 



A 
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User-Written Report Programs 



Producing a report usually requires at least two operations: sorting the SMF records 
and writing them in an appropriate format. 



Sorting SMF Records 



Any sort/merge program can be used to sort SMF records; this section describes two 
sample sort/merge exit routines that you may use with the IBM OS/VS Sort/Merge 
Program Product (Program No. 5740-SM1). (For a detailed description of this 
particular sort/merge program, see OS/VS Sort /Merge Programmer's Guide.) 

Sample Sort/Merge Exit Routines 

The IBM OS/VS Sort/Merge Program Product can, during various phases of 
execution, pass control to routines designed and written to perform specific 
functions. SYS1 .ASAMPLIB has two sample routines that receive control from 
exits El 5 and E35 of this sort/merge program. The sample El 5 exit routine, called 
SMFE15, extracts all SMF records without a job log identification (job name and 
time and date that the reader recognized the JOB card) from the SMF dump data 
set. SMFE15 retains the dump header and dump trailer records (types 2 and 3) in 
the temporary data set HDRDATA. It retains all other system-oriented records 
(records without a job log identification) in the temporary data set SORDATA. 

The sample E35 exit routine, called SMFE35, places all the records extracted by 
the SMFE15 routine in the sort output data set. These records are inserted in the 
data set as follows: dump header records, dump trailer records, all other system- 
oriented records, and the sorted job-oriented records. 

Note: If tape work devices are used, the minimum record length the IBM 
Sort/Merge Program Product can sort is 18 bytes. Otherwise, the minimum is one 
byte. The sample routines SMFE15 and SMFE35 use SMF record types through 
13 for input; the minimum length of these SMF records is 18 bytes. 

Figure 28 shows sample JCL for obtaining a listing of the SMFE15 and SMFE35 
exit routines from SYS1 .ASAMPLIB. Figure 28 also shows sample JCL for obtaining 
a listing of the SYS1 .ASAMPLIB member named SMFSORT. SMFSORT contains 
sample JCL for executing the IBM OS/VS Sort/Merge Program Product. 
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//PRINT 


JOB 


123456,SMITH 


// 


EXEC 


PGM=IEBPTPCH 


//SYSPRINT 


DD 


SYSOUT=A 


//SYSUT1 


DD 


DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 


II 




UNIT=xxxx,VOLUME=SER=xxxxxx 1 


//SYSUT2 


DD 


SYSOUT=A 


//SYSIN 


DD 


* 




PRINT 


TYPORG=PO,MAXNAME=4,MAXFLDS=4 




MEMBER 


NAME=SMFSORT 




RECORD 


FIELD=(80) 




MEMBER 


NAME=SMFE15 




RECORD 


FIELD=(80) 




MEMBER 


NAME=SMFE35 




RECORD 


FIELD=(80) 


/* 







( 



1 The volume and unit parameters depend on your installation's request. 
Figure 28. Sample JCL for Obtaining a Listing of Sample Sort Exit Routines 



To include the sample exit routines in your sort application, you must assemble 
and link-edit them before executing the sort/merge program. Figure 29 shows 
sample JCL for this procedure, including one possible sort application. In this 
example, SMF records are to be sorted first on the job log identification (major 
control field), and then on the date and time portions of the time stamp (minor 
control fields). Displacements of these fields (as shown in the next chapter) are 14, 
6, and 2. Note, however, that you must add an additional four bytes for the RDW 
and one byte for the sort procedure's initial count of 1 to these displacements. 
Hence, displacements 19,11, and 7 are shown in the SORT FIELDS= statement 
in Figure 29. 
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//SMFSORT JOB 

//STEP1 

//ASM .SYS IN 

(E 15 Source Deck) 

/• 

//LKED.SYSLMOD DD 



II 
II 
//LKED.SYSIN 



MSGLEVEL=1 
EXEC ASMFCL 1 
DD 



DSN AM E=SM F 1 .EX ITS,U N IT=231 4 2 



DISP=(NEW,KEEP),SPACE=(TRK,(10,5,D), 

VOL=SER=231400 
DD 
NAME E15(R) 3 



//STEP2 EXEC 

//ASM .SYS IN DD 

(E35 Source Deck) 

/* 

//LKED.SYSLMOD DD 

II 

//LKED.SYSIN DD 

NAME 
/* 

//SORTSTEP EXEC 

//SYSOUT DD 

//SORTLIB DD 

//EXITLIB DD 

// 

//SORTIN DD 

// LABEL 

//SORTWK01 DD 

//SORTWK02 DD 

//SORTWK03 DD 

//SORTOUT DD 

// DISP=(, 

//SORDATA DD 

II 

//HDRDATA DD 

II 
//SYS IN DD 

SORT 

MODS 

END 
/* 



ASMFCL 1 



DSNAME=SMF1.EXITS,DISP=(OLD,KEEP), 2 

U N IT=231 4, VO L=SE R=231 400 

• 

E35(R) 3 

PGM=SORT,REGION=100K 4 

SYSOUT=A 

DSNAME=SYS1 .SORTLIB,DISP=SHR 

DSNAME=SMF1.EXITS,DISP=(OLD,KEEP), 5 

UNIT=2314,VOL=SER=231400 

UNIT=2400,VOL=SER=SYSMAN,DISP=OLD, 6 
=(,SL),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

UNIT=2314,SPACE=(TRK,(50),,CONTIG) 8 

UNIT=2314^PACE=(TRK,(50),,CONTIG) 8 

UNIT=2314,SPACE=(TRK,(50),,CONTIG) 8 

UNIT=2400,DSNAME=SMF1.SORTOUT,LABEL=(,SL), 9 
KEEP),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

UNIT=SYSDA,SPACE=(CYL,(1,1)), 10 

DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

UNIT=SYSDA,SPACE=(TRK,(5,5)), 10 

DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

• 

FIELDS=(19,16,A,11,4,A,7,4,A),FORMAT=BI,SIZE=E4000 11 
E15=(E15,700,EXITLIB,N),E35=(E35,1500,EXITLIB,N) 11 



1 EXEC statement for cataloged procedure ASMFCL (assemble and link-edit). (For a description 
of the ASMFCL procedure, see OS/VS-VM/370 Assembler Programmer's Guide.) 

2 The sample sort exit routines will be link-edited into data set SMF1. EXITS. 

3 Link-edit control statements specifying that E15 and E35 will be the load module names of the 
exit routines. 

4 EXEC statement for the sort/ merge program. 

5 Data set SMF1. EXITS is specified as the library in which sort exit routines can be found. 

"Input to the sort program is the SMF dump data set, contained on a tape having a volume 
serial number of SYSMAN. 

7 The LRECL value must be specified and can be larger than the BLKSIZE value because records 
might be segmented. The LRECL value must be as large as the longest SMF record being created 
plus four bytes for the RDW. The BLKSIZE must be equal to one-half the BUF parameter. Modify 
these parameters according to the installation's buffer size and the longest record to be collected. 

8 Three sort work units are defined as being direct access devices. 



10 



'The sort output data set is to be written on tape. 

Two data sets required by the sample sort exit routines are defined on direct access devices. 

11 The sort/merge control statements define the sort control fields and exit routines to be used 
in this sort application. 



Figure 29. Sample JCL for Executing a Sort Procedure 
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Designing a Report Program 



The basic operations of a report program are formatting and printing data from 
SMF records. The input to a report program is normally the sorted SMF data set. 



{ 



RECORD 
TYPE 



02 
08 



01 
13 



05 



06 



12 
03 



SYS1.ASAMPLIB has a sample assembler source report program, called 
SMFFRMT. Figure 30 illustrates sample output from the SMFFRMT program. 
To use this program to print selected types of SMF records, specify the record 
types' to be printed, separated by commas, in the PARM field of the EXEC 
statement. To print all record types, the PARM parameter is not required. 



HEADER/RECORD 



0102 00681590 0072017F C2C2F4F5 

0108 0066D2E5 007201 7F C2C2F4F5 

002E 082300090802000D0808000E0808000F2008023020080231 200802 

3220080233200802342008023520080236 

0101 0066D2E8 0072017F C2C2F4F5 

0000602C 0066D2E8 00000000 00000000 00000000 

010D 0066D32F 0072017F C2C2F4F5 

002E 000040000001404040404040404040404040404040C1 01020000 

000340404040404040404040404040C1D1D4 

010A 00672333 0072017F C2C2F4F5 

4040404040404040 00000000 00000000 4040404040404040 0006 
0801000C 

0105 00677297 0072017F C2C2F4F5 

C1C1D1E2F5F6C1F0 00672FFE 0072017F 0000000000000000 01 
006769F5 0072017F 00000000 0000 06 00673036 0072017F 
00 8000000000 00 0801 CI 00 00000000000000000000000000 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 
000173 01 15 F7F6F0F1F0F1F3F1F6F2F0F2F7D5F0F2F2O7D9D6C4 

0106 006774D1 007201 7F C2C2F4F5 

C1C1D1F2F5F6C1F0 00672FFE 0072017F 0000000000000000 C1 
00677408 0072017F 00000008 00 01 40404040 C3C5D5E3D9C1 
D340 0000000000000000 00000000 00000000 00000000 000000 
00 00000000 0.0000000 00 00 

0105 0067AE1F 0072017F C2C2F4F5 

C1C1D1E2F5F6C2F0 00677F2F 0072017F 0000000000000000 01 
00678298 0072017F 00000000 0000 06 00677F68 0072017F 
00 80000.00000 00 0801 C1 00 00000000000000000000000000 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 
00031C 01 15 F7F6F0F1F0F1F3F.1F6F2F0F2F7D5F0F2F2D7D9D6C4 

0106 0067B073 007201 7F C2C2F4F5 

C1C1D1E2F5F6C2F0 00677F2E 007201 7F 0000000000000000 C1 
0067AF96 007201 7F 00000008 00 01 40404040 C3C5D5E3D9C1 
D340 0203010000000000 E3D54040 C8D54040 00000000 000000 
00 C3D6D7F1 C6D3C1F1 04 CO 

010C 0067B81A 0072017F C2C2F4F5 

00009B2F 0067B7FF 0000051A 000005BF 00000002 

0103 0068161A 0072017F C2C2F4F5 



DATE 
PAGE 



BB45 
BB45 



720117 
1 



.KY BB45 

. .KY 



BB45 

AJM 
BB45 



*AAJS56A0 
*. . .5 



BB45 



. . . A * 

. PENCE JW * 

7601013162027NO22PROD * 



* J BB45 * 

*AAJS56A0 A * 

* CENTRA* 

*L * 



* BB45 * 

*AAJS56B0 * 



. . . A 

. PENCE JW 
76010131 62027NO22PROD 



BB45 



*L TN 

*. COP1 FLA1 . . 



. . . . A * 

CENTRA* 



Figure 30. Sample Output from SMFFRMT 



Figure 31 shows sample JCL for executing the SMFFRMT program after you 
have assembled it and link-edited it into SYS1.LINKLIB. 



//FORMAT 


JOB 


//FRMT 


EXEC 


//REPORT 


DD 


//SMFDATA 


DD 


II 





MSGLEVEL=1 

PGM=SMFFRMT,PARM='1, 2,3,5,6,8,9,10,1 1,12,13' 

SYSOUT=A,DCB=(BLKSIZE=1089) 2 

DISP=(OLD,KEEP),LABEL=(,SL),VOL=SER=xxxxxx, 

UNIT=2400,DCB=(RECFM=VBS,BLKSIZE=200,LRECL=600) 1 



1 The LRECL value must be specified and can be larger than the BLKSIZE value because records 

might be segmented. The LRECL value must be as large as the longest SMF record being created 

plus four bytes for the RDW. The BLKSIZE must be equal to one-half the BUF parameter. 

Modify these parameters according to the installation's buffer size and the longest record to be 

collected. See Figure 1 for the JCL defining the SMFDATA data set. 

2 
The BLKSIZE value must be a multiple of 121. The record format is FBA. 

Figure 31. Sample JCL for Executing SMFFRMT 



70 OS/VS1 System Management Facilities (SMF) 



SMF Records 



This chapter fully describes all of the SMF-formatted records. Note that the fields 
in these records marked "Reserved" are for use by SMF and are not available for 
your use. 



Standard SMF Record Header 



Each record written to the SMF data set by the SMF write ( r routine contains the 
standard SMF record header. Each record written to the SMF data set by user- 
written routines should also include the standard record header. Figure 32 illustrates 
the header; its length is 14 bytes. 



Offsets 


Name 


Length 


Format 


Source 


Description 








(The "Name" field in all 
of the SMF records 
contains the symbolic 
addresses defined by the 
IFASMFR macro 
instruction.) 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 




1 


binary 


internal 


Record type 


2 


2 




4 


binary 


SVC 11 

or 
SVC 83 


Time, in hundredths of a 
second, record was moved 
to SMF buffer 1 


6 


6 




4 


packed 


SVC 11 

or 
SVC 83 


Date record was moved to 
SMF buffer, in the form 
00YYDDDF where F is 
the sign 1 


10 


A 




4 


EBCDIC 


JMRCPUID 

or 
SMCASID 


System identification 
(taken from SID 
parameter 



1 1n record types 2 and 3, these fields indicate the time and date that the record was moved to the dump 
data set. In record types 4 and 5, these fields indicate the time and date that the job or job step 
terminated. 

Figure 32. Standard SMF Record Header 

Note: When using the SMFWTM macro instruction to write a record to the SMF 
data set, you must add a record descriptor word (four bytes) to the beginning of the 
record header; the address passed to the macro instruction must point to the 
beginning of the record descriptor word (RDW). For a discussion of the RDW, see 
OS/VS Data Management Services Guide. 
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Summary of SMF Records 

( 

Figure 33 summarizes the SMF records according to the type of data they collect, 
such as VSAM or RTAM data, and the events (or status indicators) that cause SMF 
to generate the records. Also included in Figure 33 is a summary of the DSV and 
OPT SMFxxxxx parameters that control whether each record type is to be written 
to the SMF data set. To write all SMF-formatted records (except record types 2, 3 
and 7) to the SMF data set, you must specify MAN=ALL and a value for the BUF 
parameter. To write record type 21 to the SMF data set, you must specify 
ESV=SMF in the SCHEDULR macro instruction at SYSGEN time. 
To write record type 17 for temporary data sets, you must specify REC=2. 

For a summary of the sizes of the SMF records, see "SMF Buffer" in the chapter 
"System Requirements and Considerations." 
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Catagory of Data 






Record 
Type 


SMFxxxxx Definition 




DSV= 


OPT= 


Day Data 


IPL 









Devices online at IPL 


8 






19 


1,3 




22 






Partition defined 


13 






End of day 


12 






19 


1,3 




Machine Data 


Accumulated wait time 


1 






Devices varied online 


9 






22 






Devices recovered at allocation 


10 






Devices varied offline 


11 






22 






Auxiliary 
Storage Data 


Space available on DASD volumes: 
at IPL, after HALT EOD or SWITCH 
SMF command, when demounted 


19 


1,3 




Tape volume closed or processed by 
EOV 


21 






VSAM data space defined, extended 
or deleted 


69 


1,3 




Processing 
Data 


Step processing 


4 




2 


Job processing 


5 






SYSOUT processing 


6 






Job initiated 


20 






Non-VSAM 
Data Set 
Activity 
Data 


Data set 
closed or 
processed 
by EOV 


Data set opened for 
INPUT or RDBACK 


14 


2,3 


2 


Data set opened for 
OUTPUT, UPDAT, 
INOUT,or OUTIN 


15 


2,3 


2 


Data set scratched 


17 


2,3 


2 


Data set renamed 


18 


2,3 


2 


VSAM 
Data Set 
Activity 
Data 


Component or cluster opened 


62 


2,3 


2 


Entry defined 


63 


2,3 


2 


Component or cluster status 


64 


2,3 


2 


Entry deleted 


67 


2,3 


2 


Entry renamed 


68 


2,3 


2 


RTAM Data 


RTAM initialized 


43 






MODIFY RTAM command issued 


44 






STOP RTAM command issued 


45 






LOGON record received by RTAM 


47 






LOGOFF record received by RTAM 


48 






Invalid LOGON record received by 
RTAM 


49 






ACF/VTAM Data 


ACF/VTAM Tuning Statistics 


50 






Subsystem Data 


Subsystem Data 


51 






Record 

Management 

Data 


Dump header 


2 






Dump trailer 


3 






SMF records lost 


7 






Record descriptor word (RDW) 


ALL 


N/A 


N/A 


Block descriptor word (BDW) 


N/A 


N/A 


N/A 


Security Data 


Cryptography (5740-XY5) 


82 







Figure 33. Summary of SMF Records 



SMF Records 73 



Record Type - IPL 



Record type is written by IEESMFI2 after every IPL of the system. It includes 
the virtual and real storage sizes and the SMF options in effect. Its length is 
31 bytes. 



( 



The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMFOFLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMFORTY 


1 


binary 


internal 


Record type 


2 


2 


SMFOTME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMFODTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMFOSID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMFOJWT 


4 


binary 


SMCAJWT 


Limit, in minutes, of continuous wait time for the job 
(taken from JWT parameter) 


18 


12 


SMFOBUF 


4 


binary 


SMCABUF*2 


Number of bytes in SMF buffer (taken from BUF parameter) 


22 


16 


SMFOVST 


4 


binary 


(CVTMZ00+D/1024 


Number of 1 K bytes in virtual storage 


26 


1A 


SMFOOPT 


1 


binary 


SMCAOPT 


SMF options 

Bit Meaning When Set 

System and job accounting (OPT=1 ) 

1 System, job and step accounting (OPT=2) 

2 User exits will be taken (EXT=YES) 

3 Data set accounting (DSV=2 or 3) 

4 Volume accounting (DSV=1 or 3) 

5 Reserved 

6 Type 17 records will be written for temporary 
data sets (REC=2) 

7 Reserved 


27 


1B 


SMFORST 


4 


binary 


(CVTEORM+D/1024 


Number of 1K bytes in real storage 
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Record Type 1 — System Statistics 

Record type 1 is written by IEESMFI2 after every IPL of the system and by 
IEFSMFLK at the first job or job step termination following the expiration of a 
ten-minute interval. Its length is 34 bytes. 

This record contains the system wait time and paging counts accumulated during 
all the ten-minute intervals that expired since the last record type 1 or 1 2 was 
written. It also contains the expiration time of the last ten-minute interval. 

Notes: 

1 . If a HALT EOD or SWITCH SMF operator command is issued before the 
completion of a ten-minute interval, the wait time collected for that interval is 
written in record type 12. If the system continues processing, the next type 1 
record contains the wait time accumulated from the HALT or SWITCH command 
to the expiration of the ten-minute interval. 

2. If the operator pushes the STOP button to suspend CPU processing on an IBM 
System/370, timing of the ten-minute interval is suspended but the time-of-day 
clock continues to run. The ten-minute interval is based on CPU-processing — 
not on the time-of-day clock. Therefore, the wait time interval reflected by the 
time stamp (offset 2) is equal to the ten-minute CPU-processing interval plus the 
time that the CPU processing was stopped. 

3. The following algorithm shows the relationship among elapsed time, job time, 
wait time, and system time: 

Elapsed Time = Job Time + Wait Time + System Time 

Elapsed time is obtained by. subtracting the time stamp value on the first type 1 
record from the time stamp value on the type 12 record. 

Job time is obtained by summing the job CPU time values from all the type 5 
records produced during the elapsed time. 

Wait time is obtained by summing the wait time values from the type 1 2 record 
and all but the first type 1 records. 

System time is calculated when the other three values of the above algorithm are 
known. 
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Wait Time and Paging Count Collection 

SMF divides the CPU-processing time (elapsed time) into ten-minute intervals. The 
type 1 record written after every IPL of the system marks the beginning of the first 
ten-minute interval. At the termination of a job or job step, SMF determines 
whether at least one ten-minute interval has expired since the last type 1 record was 
written. Processing continues, as follows: 

• If a ten-minute interval has expired, a type 1 record is produced and the wait 
time and paging counts accumulated during the expired interval are moved into 
the record. 

• If more than one ten-minute interval has expired, the wait time and paging 
counts accumulated during the intervals that have expired since the last type 1 
record are moved into the record. 

• If a ten-minute interval has not expired, a type 1 record is-not produced. 

Figure 34 is an example of how SMF collects system wait time. (The process is 
similar for collecting system paging statistics.) In Figure 34, when job/step A 
terminates, three ten-minute intervals have expired. The total wait time collected 
in these intervals (783 seconds) is moved to a type 1 record. When job/step B 
terminates, a ten-minute interval has not expired since the last type 1 record was 
written; therefore, a type 1 record is not written. When job/step C terminates, 
three ten-minute intervals have expired, and the total wait time for these intervals 
(809 seconds) is moved to a type 1 record. 



( 



Wait time collected in successive 
ten-minute intervals 


217 


263 


303 


342 


265 


202 




Wait time collected in a 
type 1 record 


783 




809 




Job or job step termination 


A 


B 


C 





Figure 34. Sample Wait Time Collection 
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The format of record type 1 is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF1FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF1RTY 


1 


binary 


internal 


Record type ^ 


2 


2 


SMF1TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to fe 
SMF buffer 


6 


6 


SMF1DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form * 
00YYDDDF where F is the sign 


10 


A 


SMF1SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF1SWT 


4 


binary 


SMCAWAIT 


System wait time, in hundredths of a second, for successive 
ten-minute intervals that have expired since the last record 
type 1 or 12 was written 


18 


12 


SMF1TEXP 


4 


binary 


SMCATEXP 


Expiration time, in hundredths of a second, of the interval 
whose statistics are reported in this record 


22 


16 


SMF1PGIN 


4 


binary 


SMCAPGIN 


Number of page-ins for the entire system during the interval c 


26 


1A 


SMF1PGOT 


4 


binary 


SMCAPGOT 


Number of page-outs for the entire system during the 
interval 


30 


1E 


SMF1PGRL 


4 


binary 


SMCAPGRL 


Number of page reclaims for the entire system during the 
interval 
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Record Type 2 — Dump Header 

Record type 2 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
indicates the beginning of a dump of the SMF data set from a direct access device 
usually to a tape. Its length is 14 bytes. 

Note: Even if MAN=USER is specified in the SMFxxxxx member of 
SYS1 .PARMLIB, a type 2 record is written. 

The format is: 



( 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF2FLG 


1 


binary 


IFASMFDP 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF2RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF2TME 


4 


binary 


SVC 1 1 (Set by 
IFASMFDP) 


Time, in hundredths of a second, record was moved to the 
dump data set 


6 


6 


SMF2DTE 


4 


packed 


SVC 1 1 (Set by 
IFASMFDP) 


Date record was moved to the dump data set, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF2SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 
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Record Type 3 — Dump Trailer 

Record type 3 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
marks the end of a dump of the SMF data set from a direct access device usually 
to a tape. Its length is 14 bytes. 

Note: Even if MAN=USER is specified in the SMFxxxxx member of 
SYS 1 .PARMLIB, a type 3 record is written. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF3FLG 


1 


binary 


IFASMFDP 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF3RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF3TME 


4 


binary 


SVC 1 1 (Set by 
IFASMFDP) 


Time, in hundredths of a second, record was moved to the 
dump data set 


6 


6 


SMF3DTE 


4 


packed 


SVC 1 1 (Set by 
IFASMFDP) 


Date record was moved to the dump data set, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF3SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 
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Record Type 4 — Step Termination I 

Record type 4 is built by IEFSMFWI and written by IEFSMFLK at the normal or 
abnormal termination of a job step, or when a job step is flushed during or after job 
initiation. It is not written for a job step that follows a CANCEL operator 
command. Its length is 1 17 bytes plus (1) eight bytes for each device entry and (2) 
the length of the step accounting fields. 

This record identifies the job step by the job log identification, step name, 
number of the step within the job, user identification, and program name. If 
accounting numbers (which can be alphameric) were specified in the EXEC 
statement, they are included. 

This record also contains operating information such as the job step start and end 
times, step CPU time, amount of storage allocated and used, step termination status, 
number of records in instream DD DATA and DD * data sets for the step, device 
allocation start time, problem program start time, and storage protect key. Record 
type 4 also has an entry for each non-spooled data set that was defined by a DD 
statement. Each entry lists the EXCP count for the data set, device class, unit type, 
channel address, and unit address. 

Notes: 

1 . Data sets are recorded in the order of the step DD statements; they are not 
identified by name. (A user-written exit routine can record this order as each 
statement is validated.) 

2. The EXCP count indicates the input/output activity required by the job. It (f 
includes EXCPs issued via SVC 0, EXCPs issued in a user's program controlled ^ 
interrupt (PCI), EXCPs issued in a user's channel-end and abnormal-end 

appendages, and the input/output for VSAM data sets. It does not include 
EXCPs for system services performed in system keys as a result of the problem 
program (for example, joblib/steplib processing, overlay supervisor processing, 
and checkpoint data set processing). The EXCP count also does not include 
PCIs when ADDRSPC=REAL is specified. 

3. EXCPs for concatenated data sets residing on the same volume are accumulated 
in the device entry corresponding to the first occurrence of the UCB address for 
the device the volume is on. 

4. When chained scheduling is used, the EXCP count may not be constant between 
different runs of the same job. Chained scheduling is designed to optimize 
input/output activity; the number of EXCPs required will depend upon system 
and program interaction at the time the input/output is performed. 
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The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF4FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF4RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF4TME 


4 


binary 


SVC 1 1 (Set by 
IEFSMFWI) 


Time, in hundredths of a second, step terminated 


6 


6 


SMF4DTE 


4 


packed 


SVC 1 1 (Set by 
IEFSMFWI) 


Date step terminated, in the form 00YYDDDF, where F 
is the sign 


10 


A 


SMF4SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF4JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF4RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF4RDS 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF4UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF4STN 


1 


binary 


LCTSNUMB 


Step number (first step=1, etc.) 


39 


27 


SMF4SIT 


4 


binary 


JCTJMRSS (Set by 
IEFSMFIE) 


Time, in hundredths of a second, initiator selected this step 


43 


2B 


SMF4STID 


4 


packed 


JCTSSD (Set by 
IEFSMFIE) 


Date initiator selected this step, in the form 00YYDDDF 
where F is the sign 


47 


2F 


SMF4NCI 


4 


binary 


SCTSMF 


Number of card-image records in instream DD DATA and 
DD* data sets read by the reader for the step. (This number 
does not include records from associated data sets.) 



"The job name and the time and date that the reader recognized the JOB card for this job constitute the job 
log identification. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


51 

V 


33 


SMF4SCC 


2 


binary 


LCTSMF 


Step completion code: 

X'Occc' indicates system ABEND in the job step where ccc 
is the system ABEND code. (See OS/VS Message Library: 
VS1 System Codes.) 

X'8ccc' indicates user ABEND in the job step where ccc 
is the user ABEND code. 

X'nnnn' indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 1 5 at 
termination. 

X'0000' indicates either 

(1) the job step was flushed (not executed) because of an 
error during allocation or in a preceding job step, or 

(2) normal job completion with a return code of 0. 
Use this field in conjunction with the step termination 
indicator field (offset 83) . 


53 v 


35 


SMF4PRTY 


1 


binary 


TCBDSP 


Step priority 


54 


36 


SMF4PGMN 


8 


EBCDIC 


SCTPGMNM 


Program name (taken from PGM= parameter on EXEC 
card). If a backward reference was used (SCTSTYPE equals 
X'80'), then this field contains *.DD. 


62 


3E 


SMF4STMN 


8 


EBCDIC 


SCTSNAME 


Step name (taken from name on EXEC card) 


70 


46 


SMF4RSH0 


2 


binary 


TCTRSZ 


Partition size requested, in 1K units. If ADDRSPC=REAL 
is specified, this field equals the amount of real storage 
requested (see offset 98). 


72 


48 




2 


binary 




Reserved 


74 


4A 


SMF4H0ST 


2 


binary 


(TCTRSV- 
TCTMII\IC)»2 


Storage used, in 1K units. If ADDRSPC=REAL is specified, 
this field equals the amount of real storage requested 
(see offset 98). 


76 


4C 




6 


binary 




Reserved 


82 


52 


SMF4SPK 


1 


binary 


TCBPKF 


Storage protect key, in the form xxxxOOOO where xxxx is 
the key 


83 


53 


SMF4STI 


1 


binary 


JCTJMRCL 
JCTJMRCL 
JCTJMRCL 
JCTJMRCL 

TCBFA 
LCTTMWRK 


Step termination indicator 
Bit Meaning When Set 

Reserved 

1 Canceled by exit IEFUJV 2 

2 Canceled by exit IEFUJI 2 

3 Canceled by exit IEFUSI 2 

4 Canceled by exit IEFACTRT 2 

5 Reserved 

6 If 0, normal completion. If 1, ABEND. If step 
completion code (offset 51 ) equals 0322 or 0522, 
IEFUTL caused ABEND. If step completion code 
equals 0722, IEFUSO caused ABEND. 

7 If 0, normal completion. If 1, step was flushed. 


84 


54 




2 


binary 




Reserved 


86 


56 


SMF4AST 


4 


binary 


TCTAST 


Device allocation start time, in hundredths of a second 


90 


5A 


SMF4PPST 


4 


binary 


TCTPPST 


Problem program start time, in hundredths of a second 


94 


5E 




4 


binary 




Reserved 



{ 



2 Job steps canceled by IEFUJV, IEFUJI, and IEFUSI will not be executed; therefore bit 7 
will also be on. Job steps canceled by IEFACTRT will cause subsequent job steps to be canceled; 
bit 7 will be on for subsequent job steps. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


98 


62 


SMF4RIN 


2 


binary 


SCTSSTAT 


Record indicator 

Bit Meaning When Set 

0-6 Reserved 

7 If 0, storage is virtual. If 1 , storage is real. 

8-15 Reserved 


100 


64 


SMF4RLCT 


2 


binary 


internal 


Offset from the beginning of the record header to the 
relocate section 


102 


66 


SMF4LENN 


2 


binary 


internal 


Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 


For each device assigned to each non-spooled data set, there is an eight-byte entry with the following format. 3 


+0 




SMF4DEVC 


1 


binary 


UCBTBYT3 


Device class 


+1 




SMF4UTYP 


1 


binary 


UCBTBYT4 


Unit type 


+2 




SMF4CUAD 


1 


binary 


UCBCHA 


Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 


+3 






1 


binary 


UCBUA 


Unit address 


+4 




SMF4EXCP 


4 


binary 


TCTDCTR 


EXCP count (see notes for this record) 


After the device entries are the following fields: 






Accounting Section: 










+0 




SMF4LNTH 


1 


binary 


internal 


Length of accounting section, excluding this field 
Step CPU time, in hundredths of a second ^ 


+1 




SMF4SEJM 


3 


binary 


ACTJTIME 
(inJCT) 


+4 




SMF4NAF 


1 


binary 


internal 


Number of accounting fields 


+5 




SMF4ACTF 


variable 


EBCDIC 


EXEC statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 


Relocate Section: 










+0 5 




SMF4PGIN 5 


4 


binary 


TCTPGIN (Set by 
IEAPGSPP) 


Number of page-ins done to the partition. This field 
includes page-ins required through page faults, specific page 
requests, and page fixes. 


+4 




SMF4PGOT 


4 


binary 


TCTPGOUT (Set by 
IEAPGSPP) 


Number of page-outs done to the partition. This field 
includes pages stolen by the paging supervisor as a result of 
infrequent use. 



3 For a DD DUMMY data set, the entry is zero. (A DD DUMMY entry results when a forward reference 
to a DD statement having that DD name is not found or when DD DUMMY is specified.) 

4 lf TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 is 
specified on the EXEC statement and a job time limit is not specified on the JOB statement, all timing 
for the job step is eliminated. For more information, see the IEFUTL exit. 

CPU time is not expected to be constant between different runs of the same job step. One or more of 
the following factors may cause small variations in CPU time: channel program retries, CPU architecture 
(such as storage buffering), cycle stealing with integrated channels, and queue searching (such as enqueue). 

5 The displacement of this field depends upon the size of the accounting fields and the number of 
devices. Offset 100 contains the displacement for this field. 
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Record Type 5 — Job Termination 

Record type 5 is built by IEFSMFWI and written by IEFSMFLK at the normal or 
abnormal termination of a job, or when a job step is flushed during or after job 
initiation. Its length is 1 17 bytes plus the length of the job accounting fields. (The 
maximum length of this record is 261 bytes.) 

This record identifies the job by job log identification, user identification, priority, 
input class, SYSOUT class indicators, and programmer's name. If accounting 
numbers (which can be alphameric) were specified in the JOB statement, they are 
included. 

This record also contains operating information such as the job start and end times, 
number of steps in the job, number of records in instream DD DATA and DD* data 
sets for the job, job termination status, reader device class and unit type, storage pro- 
tect key, and job CPU time. (The job CPU time equals the sum of the job step times.) 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF5FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF5RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF5TME 


4 


binary 


SVC 1 1 (Set by 
IEFSMFWI) 


Time, in hundredths of a second, job terminated 


6 


6 


SMF5DTE 


4 


packed 


SVC 1 1 (Set by 
IEFSMFWI) 


Date job terminated, in the form 00YYDDDF where F is 
the sign 


10 


A 


SMF5SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF5JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF5RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


26 


1A 


SMF5RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF5UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF5NST 


1 


binary 


LCTSNUMB 


Number of steps in the job 


39 


27 


SMF5JIT 


4 


binary 


JCTJMRJT (Set by 
IEFSMFIE) 


Time, in hundredths of a second, initiator selected the job 


43 


2B 


SMF5JID 


4 


packed 


JCTJMR JD (Set by 
IEFSMFIE) 


Date initiator selected the job, in the form 00YYDDDF 
where F is the sign 


47 


2F 


SMF5NCI 


4 


binary 


JMRJOBIN 


Number of card-image records in instream DD DATA and 
DD* data sets read by the reader for the job. (This num- 
ber does not include records from associated data sets.) 



J The job name and the time and date that the reader recognized the JOB card for this job constitute the 
job log identification. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


51 


33 


SMF5JCC 


2 


binary 


LCTSMF 


Job completion code: 

X'Occc' indicates system ABEND in the last job step where 
ccc is the system ABEND code. (See OS/VS Message 
Library: VS1 System Codes.) 

X'8ccc' indicates user ABEND in the last job step where ccc 
is the user ABEND code. 

X'nnnn' indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 

X'0000' indicates either 

(1) a job step was flushed (not executed) because of an 
error during allocation or in a preceding job step, or 

(2) normal job completion with a return code 0. 

Use this field in conjunction with the job termination 
indicator field (offset 62). 


53 


35 


SMF5JPTY 


1 


binary 


JLPPRI 
(in JLPA) 


Job priority. This field normally equals the user-assigned 
priority of to 1 3, but if the job fails while being scheduled, 
this field equals 14. 


54 


36 


SMF5RSTT 


4 


binary 


JMRDRSTP 


Time, in hundredths of a second, reader recognized the end 
of the job. (This does not include time to read records from 
associated data sets.) 


58 


3A 


SMF5RSTD 


4 


packed 


JMRDRSTP+4 


Date reader recognized the end of the job, in the form 
00YYDDDF where F is the sign. 


62 


3E 


SMF5JBTI 


1 


binary 


JCTJMRCL 
JCTJMRCL 
JCTJMRCL 
JCTJMRCL 

TCBFA 


Job termination indicator 
Bit Meaning When Set 

Reserved 

1 Canceled by exit I EFUJV 

2 Canceled by exit lEFUJI 

3 Canceled by exit IEFUSI 

4 Canceled by exit lEFACTRT 

5 Reserved 

6 If 0, normal completion. If 1, ABEND. 

7 Reserved 


63 


3F 


SMF5SMCI 


5 


binary 


JCTCTOJ 


SYSOUT class indicator. 2 (This field is usually taken from 
the SYSOUT parameter on the DD statement.) 


68 


44 




1 


binary 




Reserved 


69 


45 


SMF5RDCL 


1 


binary 


JMRRDR 


Reader device class 3 


70 


46 


SMF5RUTY 


1 


binary 


JMRRDR 


Reader unit type 3 


71 


47 


SMF5JICL 


1 


EBCDIC 


JLPID 
(in JLPA) 


Job input class (default equals 'A') 


72 


48 


SMF5SPK 


1 


binary 


TCBPKF 


Storage protect key, in the form xxxxOOOO where xxxx is 
the key 


73 


49 




3 


binary 




Reserved 


76 


4C 


SMF5QID 


7 


EBCDIC 


JMRRESID 


User's logon identifier. Non-terminal oriented jobs have an 
identifier of 'CENTRAL'; terminal-oriented jobs use the 
contents of the JMRRESID field for the terminal through 
which the job was submitted. 



2 Each bit of the indicator represents the following classes: 



(Continued) 



ByteO 


Byte 


1 


Byte 2 


Byte 3 


Byte 4 


Bit Class 


Bit 


Class 


Bit 


Class 


Bit 


Class 


Bit Class 


A 





I 





Q 





Y 


6 


1 B 


1 


J 


1 


R 


1 


Z 


1 7 


2 C 


2 


K 


2 


S 


2 





2 8 


3 D 


3 


L 


3 


T 


3 


1 


3 9 


4 E 


4 


M 


4 


U 


4 


2 




5 F 


5 


N 


5 


V 


5 


3 




6 G 


6 





6 


w 


6 


4 




7 H 


7 


P 


7 


X 


7 


5 





3 This field is not filled in for jobs submitted via an internal reader. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


83 


53 




1 


EBCDIC 




Reserved 


84 


54 




8 


binary 




Reserved 


92 


5C 


SMF5TLEN 


1 


binary 


internal 


Length of rest of record excluding this field 


93 


5D 


SMF5PRGN 


20 


EBCDIC 


ACTPRGNM (in JCT) 


Programmer's name 


113 


71 


SMF5JCPU 


3 


binary 


ACTJTIME (in JCT) 


Job CPU time, in hundredths of a second 


116 


74 


SMF5ACTF 


1 


binary 


ACTJNFLD (in JCT) 


Number of accounting fields 


117 


75 


SMF5JSAF 


variable 


EBCDIC 


JOB statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 



< 



4 If TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 is specified on an 
EXEC statement and a job time limit is not specified on the JOB statement, all timing for that job step is eliminated. 
For more information, see the IEFUTL exit. 

CPU time may not be constant between different runs of the same job. One or more of the following factors may cause 
small variations in CPU time: channel program retries, CPU architecture (such as storage buffering), cycle stealing with 
integrated channels, and queue searching (such an enqueue). 



( 
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Record Type 6 - Output Writer 

Record type 6 is written by IEFOSC4A (a subroutine called by IEFOSC01,IEFOSC02, 
IEFOSC05, and IEFOSC09) when the writer has finished processing a SYSOUT 
class, or form within a class, for a job. It is also written if the writer is held while 
writing a SYSOUT data set. If two or more forms are used within a class, one type 6 
record is produced for each form. Its length is 99 bytes. 

For output going to an IBM 3800, this record is written once for every data set. 
For data sets not going to an IBM 3800, fields SMF6CPS through SMF6BID are 
meaningless. 

This record identifies the output writer by SYSOUT class and form number, and 
identifies the job by job log identification and user identification. It also contains 
information on the output writer activity such as the number of logical records 
processed, number of data sets processed, writer start and end times, and input/ 
output status indicator. For output going to an IBM 3800, it contains information 
on how the output was processed. 

Note: If an external writer or user supplied writer is used, an incomplete record 
type 6 is produced for each data set (if the writing of records is allowed). The num- 
ber of logical records (offset 47) and the I/O status indicator (offset 51) fields are zero. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF6FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF6RTY 


1 


binary 


internal (Set by 
IEFVMD) 


Record type 


2 


2 


SMF6TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF6DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF6SID 


4 


EBCDIC 


SMCASID(SVC83) 


System identification (taken from SID parameter) 


14 


E 


SMF6JBN 


8 


EBCDIC 


EMRJOB (Set 
by IEFOSC4A) 


Job name 1 


22 


16 


SMF6RST 


4 


binary 


JMR ENTRY (Set 
by IEFOSC4A) 


Time, in hundredths of a second, reader recognized 
the JOB card for this job 1 


26 


1A 


SMF6RSD 


4 


packed 


JMREDATE (Set 
by IEFOSC4A) 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 



2 The job name and the time and date that the reader recognized the JOB 
for this job constitute the job log identification. 



card 



(Continued) 
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Offsets 


Name 


Length 


Format I Source 


Description 


30 


1E 


SMF6UIF 


8 


EBCDIC 


DSBUSEID or 

JMRUSEID(Setby 

IEFOSC4A) 


User identification (taken from common exit parameter 
area). In the case of a forms change, the information in the 
DSBUSEID field is used; the DSBUSEID field is set for 
each job step from the JMRUSEID field before the 
IEFACTRT step/job termination exit is taken. 


38 


26 


SMF60WC 


1 


EBCDIC 


DSBCLAS (Set by 
IEFOSC4A) 


SYSOUT class 


39 


27 


SMF6WST 


4 


binary 


SVC 1 1 (Set by 
IEFOSC4A) 


Time of SYSOUT start, in hundredths of a second 


43 


2B 


SMF6WSD 


4 


packed 


SVC 1 1 (Set by 
IEFOSC4A) 


Date of SYSOUT start, in the form OOYYDDDF where F 
is the sign 


47 


2F 


SMF6NLR 


4 


binary 


Calculated by 
IEFOSC01 or 
IEFOSC02;moved 
to buffer by 
IEFOSC4A 


Number of logical records written by the writer, by form 
number and class. This field includes job-related records if 
the JOBLOG=YES parameter is specified in the JES macro 
at system generation. 


51 


33 


SMF6I0E 


1 


binary 


Set during writer 
processing in 
IEFOSC4A 


I/O status indicator 

Bit Meaning When Set 

0-3 Reserved 

4 I/O discontinued (remote output only) 

5 Input error 

6 Output error 

7 Input error on SYS1 .SYSJOBQE 


52 


34 


SMF6NDS 


1 


binary 


internal (Set by 
IEFOSC01 or 
IEFOSC02) 


Number of data sets completely written by the writer and 
included in this record. If a data set is held, it will be count- 
ed upon completion. For output going to an IBM 3800, 
this value is normally 1, because the record is written after 
each data set. The record is not written for an empty data 
set, but each data set is counted. The record for the non- 
empty data set following any empty data sets (or the last 
record for the job) reflects the empty data sets in this field. 


53 


35 


SMF6FMN 


4 


EBCDIC 


DSBFOR (Set by 
IEFOSC4A) 


Form number 


57 


39 


SMF6QID 


8 


EBCDIC 


JMRRESID (Set by 
IEFVMD) 


User's logon identifier. Non-terminal oriented jobs have an 
identifier of 'CENTRAL'; terminal-oriented RES jobs use 
the contents of the JMRRESID field for the terminal to 
which output was routed. Terminal-oriented CRJE jobs use 
the CRJE user ID for the terminal to which output was 
routed. 


65 


41 


SMF6CPS 


8 


EBCDIC 


Calculated by 
IEFOSC5B 


Copies distribution 


73 


49 


SMF6CHR 


16 


EBCDIC 


SPPXLAT1 (Set by 
IEFOSC4A) 


Translate table names from CHARS parameter 


89 


59 


SMF6MID 


4 


EBCDIC 


SPPMODPT (Set by 
IEFOSC4A) 


Copy modification module name 


93 


5C 


SMF6FLI 


4 


EBCDIC 


SPPIMAGE (Set by 
IEFOSC4A) 


Flash overlay name 


97 


61 


SMF6FLC 


1 


binary 


Calculated by 
IEFOSC5B 


Number of copies flashed 


98 


62 


SMF6BID 


1 


binary 


Set by IEFOSC4A 

SPPBURST 
ACBOPTJ 


Flag Byte 

Bit Meaning When Set 

BTSS was used for output 

1 OPTCD=J was used for output 
2-7 Reserved 



{ 



i 



88 OS/VS1 System Management Facilities (SMF) 



Record Type 7 — Data Lost 



Record type 7 is the first record built when an SMF data set becomes available for 
recording after a period when no data sets were available. Data existing in the SMF 
buffer is written to the newly available SMF data set before record type 7 is built in 
the buffer. Consequently record type 7 is not the first record in the data set. It is 
written by IEESMFWT and its length is 24 bytes. 

This record contains a count of the SMF records that were not written, and the 
start and end times of the period during which no records were written. (The end 
time is the time recorded in offset 2.) 

Notes: 

1. In record types 4 and 5, the time stamp reflects the time that the job step or job 
ended instead of the time that the record was moved to the SMF buffer. 
Therefore, it is possible for these records, which follow the type 7 record in the 
SMF data set, to have a time stamp earlier than that of the type 7 record. 

2. Even if MAN=USER is specified in the SMFxxxxx member of SYS1 .PARMLIB, 
a type 7 record is built and written to the SMF data set. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF7FLG 


1 


binary 


IEESMFWT 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF7RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF7TME 


4 


binary 


SVC 1 1 (Set by 
IEESMFWT) 


Time, in hundredths of a second, record was built in SMF 
buffer 


6 


6 


SMF7DTE 


4 


packed 


SVC 1 1 (Set by 
IEESMFWT) 


Date record was built in SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF7SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF7NRO 


2 


binary 


SMCADSCT 


Number of SMF records lost because no SMF data sets were 
available for recording 


16 


10 


SMF7STM 


4 


binary 


SMCADSTM (Set by 
IEESMFWT) 


Start time, in hundredths of a second, of period during 
which no SMF data sets were available for recording 


20 


14 


SMF7STD 


4 


packed 


SMCADSTM (Set by 
IEESMFWT) 


Start date of period during which no SMF data sets were 
available for recording, in the form 00YYDDDF where F 
is the sign 
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Record Type 8 - I/O Configuration 

Record type 8 is written by IEESMFI2 after the IPL of the system is completed and 
the SET DATE operator command is issued. This record identifies each device that 
is online at IPL by device class, unit type, channel address, and unit address. Its 
length is 1 6 bytes plus four bytes for each device online at IPL. 



( 



The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF8FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF8RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF8TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF8DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF8SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF8LENN 


2 


binary 


internal 


Length of rest of record including this field 


For i 
+0 
+1 
+2 

+3 


sach on 


line device, then 
SMF8IODV 


i is a four 
1 
1 
1 

1 


-byte entr\ 
binary 
binary 
binary 

binary 


t with the following fo 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


rmat: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 



i 
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Record Type 9 - VARY ONLINE 

Record type 9 is written by ICBMSGOO (for the 3850 Mass Storage Control) and 
IEE2303D when a VARY ONLINE command is processed. This record identifies 
the device being added to the configuration by device class, unit type, channel 
address, and unit address. Its length is 16 bytes plus four bytes for each device 
varied online. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF9FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF9RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF9TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF9DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF9SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF9LENN 


2 


binary 


internal 


Length of rest of record including this field 


Fore 
+0 
+1 
+2 

+3 


>ach de 


/ice varied online 
SMF9DVAD 


}, there is 
1 
1 
1 

1 


a four-byt 
binary 
binary 
binary 

binary 


e entry with the folic 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


wing format: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 
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Record Type 10 — Allocation Recovery 

Record type 10 is written by IEFXJIMP after a successful device allocation recovery. 
Its length is 40 bytes plus four bytes for each device that is made available. 



( 



This record identifies the device that is made available by device class, unit type, 
channel address, and unit address. It identifies the job requiring the allocation by 
job log identification and user identification. 

Note: This record is not produced if the operator cancels the job instead of 
attempting recovery. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF10FLG 


1 , 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF10RTY 


1 


biliary 


internal 


Record type 


2 


2 


SMF10TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF10DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF10SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF10JBN 


8 


EBCDIC 


JMRJOB 


Job name. This field contains blanks if allocation recovery 
is for a system task 1 


22 
26 


16 


SMF10RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job. This field equals zero if allocation recovery 
is for a system task 1 


1A 


SMF10RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the form 
00YYDDDF where F is the sign. This field equals zero if 
allocation recovery is for a system task 1 


30 


1E 


SMF10UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF10LN 


2 


binary 


internal 


Length of rest of record including this field 


For e 
+0 
+1 
+2 

+3 


sach de 


vice made availa 
SMF10DEV 


ale, there 
1 
1 
1 

1 


is a four-b 
binary 
binary 
binary 

binary 


/te entry with the fo 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


lowing format: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 



^The job name and the time and date that the reader recognized the JOB card 
for this job constitute the job log identification. 
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Record Type 1 1 - VARY OFFLINE 

Record type 1 1 is written when a VARY OFFLINE command is processed, It is 
written by ICBMSGOO (for the 3850 Mass Storage Control), IEFXCSSS, and 
IEFZHMSG. This record identifies the device being removed from the configuration 
by device class, unit type, channel address, and unit address. Its length is 16 bytes 
plus four bytes for each device varied offline. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF11FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF11RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF11TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF11DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF11SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF11LN 


2 


binary 


internal 


Length of rest of record including this field 


For 6 
+0 
+1 
+2 

+3 


>ach de 


vice varied off I in 
SMF11DEV 


e, there is 
1 
1 
1 

1 


a four-by 
binary 
binary 
binary 

binary 


te entry with the folic 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


swing format: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 
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Record Type 12 — End-of-Day 



Record type 12 is written by IEE1403D when a HALT EOD or SWITCH SMF 
command is processed. This record contains the system wait time and paging 
statistics accumulated between the expiration time recorded in the last record type 
1 or 12, and the time the HALT or SWITCH command was issued. Its length is 34 
bytes. 



c 



Note: If the system continues running after the HALT EOD or SWITCH SMF 
command is issued, the next record type 1 contains the wait time accumulated 
from the HALT or SWITCH command to the expiration of the next ten-minute 
interval. For more information about the collection of system wait time and 
paging statistics, see record type 1 . 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF12FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF12RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF12TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF12DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF12SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF12SWT 


4 


binary 


SMC AWAIT 


System wait time, in hundredths of a second, since the 
expiration time recorded in the last record type 1 


18 


12 


SMF12TEX 


4 


binary 


SVC 1 1 (Set by 
IEE1403D) 


Expiration time, in hundredths of a second, of the 
collection period whose statistics are reported in this 
record 


22 


16 


SMF12PGI 


4 


binary 


SMCAPGIN 


Number of page-ins for the entire system during the 
interval 


26 


1A 


SMF12PGO 


4 


binary 


SMCAPGOT 


Number of page-outs for the entire system during the 
interval 


30 


1E 


SMF12PGR 


4 


binary 


SMCAPGRL 


Number of page reclaims for the entire system during the 
interval 



V 
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Record Type 13 — Dynamic Storage Configuration 

Record type 13 is written by IEEDFINA at IPL and after each DEFINE operator 
command is processed. This record identifies each active problem program partition 
by the partition number, storage assigned to the partition, number of job classes, 
and job classes. Its length is 16 bytes plus ,22 bytes for each partition entry. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF13FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF13RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF13TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF13DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF13SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF13LTH 


2 


binary 


internal 


Length of rest of record, including this field 


For ( 


sach ac 


tive problem pro 


gram pari 


tition, there is a 22-byte entry with the following format: 


+0 




SMF13PN 


1 


binary 


(TCBIBF- 
TCBID) forPO 


Partition number 


+1 




SMF13SH0 


2 


binary 


(BBXPTHIL- 
BBXPT LOU/1 024 


Storage assigned to the partition, in 1 K blocks 


+3 






2 


binary 




Reserved 


+5 




SMF13NJC 


1 


binary 


internal 


Number of job classes 


+6 




SMF13JC 


16 


EBCDIC 


SD33GRP (in PIB) 


Job classes specified by A-Z and 0-9; system task partitions 
are specified by *. The job classes are in their specified 
order, adjusted right, and padded with blanks. 
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Record Type 14 - INPUT or RDBACK Data Set Activity 

Record type 14 is written for non-VSAM direct access or tape data sets that are 
defined by DD statements and opened for INPUT or RDBACK processing by 
problem programs. It is written by IFG0202H and IFG0202I when a data set, as 
described above, is closed or processed by EOV. Its length varies from 288 to 
6,412 bytes, depending upon the number of volumes for the data set. 

This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see OS/VS1 System Data Areas. 

Notes: 

1. Record type 14 is not written for a data set defined by a DD* or DD DATA 

statement. For accounting purposes, the card-image count for these data sets 

is provided in record type 4. , 

/ 

2. When opening generation data group (GDG) data sets using only one DD 

statement, the DD name is recorded only in the first type 14 record. The other 
type 14 records generated contain blanks in the DD name field. 

The format is: 



( 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF14FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF14RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF14TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF14DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF14SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF14JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF14RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job l 


26 


1A 


SMF14RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign x 


30 


1E 


SMF14UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF14RIN 

SMF14EOV 

SMF14DAD 
SMF14TDS 

SMF14DDA 
SMF14IS 

SMF14JIS 


2 


binary 


internal 

UCBTYP 
JFCBDSNM 

DCBDSORG 
DCBDSORG 

JFCDSORG 
(in JFCB) 


Record and data set indicator 
Bit Meaning When Set 

Reserved 

1 Record written by EOV (Register 14=0 if CLOSE; 
register 14=4 if EOV) 

\?J> DASD device 

3 Temporary data set. (A data set is temporary if it 
has a system-generated name, is created within a job 
or job step, and exists only for the duration of that 
job or job step.) 

4 DCBDSORG=DA. (The data set organization being 
used is direct access.) \ 

5 DCBSORG=IS and DCBMACRF not EXCP. (The 
data set organization being used is indexed 
sequential and the EXCP access method is not 
being used.) 

6 JFCDSORG=IS. (The data set organization being 
used is indexed sequential.) - 

7-15 Reserved 






1 The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Offsets 1 Name 


Length 


Format 


Source 


Description 


Sect 
40 


ion Siz 
28 


es: 

SMF14SDC 


1 


binary 


internal 


Size of OCB/DEB section. This field equals 24. 


41 


29 


SMF14NUC 


1 


binary 


internal 


Number of UCB sections. There is always one UCB section 
for each UCB currently processing except for ISAM and 
BPAM -concatenated data sets. For ISAM data sets, this 
field is calculated as: one for the index extent, one per 
volume for primary extents, and one for the overflow extent. 
For BPAM-concatenated data sets, there is one UCB section 
for each data set in the concatenated data set. 


42 


2A 


SMF14SUC 


1 


binary 


internal 


Size of each UCB section. This field equals 24. 


43 


2B 


SMF14SET 


1 


binary 


internal 


Size of ISAM extension section. This field equals 28 
(or if there are no ISAM data sets). 


44 


2C 


SMF14RV1 


4 


binary 




Reserved 


TIO 

48 


TSect 
30 


on — a portion c 

SMFTIOE1 


>f the TIC 

1 


)T, includi 
binary 


ng: 
TIOELNGH 


Length, in bytes, of the DD entry (including all device 
entries) 


49 


31 


SMFTIOE2 


1 


binary 


TIOESTTA 


Status indicator. This field indicates the tape label 
processing to be performed; whether unallocating, 
rewinding, or unloading tape data sets is required; and 
whether this is the first DD entry for a split cylinder. 


50 


32 


SMFTIOE3 


1 


binary 


TIOEWTCT 


Number of devices requested for this data set during 
allocation 


51 


33 


SMFTIOE4 


1 


binary 


TIOELINK 


During allocation, this field indicates a link to the 
appropriate prime split, unit affinity, volume affinity, or 
suballocate TIOT entry. After allocation, it is a data set 
and device indicator. 


52 


34 


SMFTIOE5 


8 


EBCDIC 


TIOEDDNM 


DDname 


60 


X 


SMFTIOE6 


3 


binary 


TIOEJFCB 


Relative track address (TTR) of the JFCB. During 
allocation, this field contains the TTR of the SIOT. 


63 


3F 


SMFTIOE7 


1 


binary 


TIOESTTC 


Status indicator during allocation only and set to zeros at 
the end of allocation. This field indicates whether the unit 
affinity, volume affinity, and suballocate TIOT entry are 
primary or secondary. 


JFCB Section: 

64 | 40 | SMFJFCB1 


176 


binary 


JFCB 


The JFCB, excluding JFCB extensions 


DCE 
240 


l/DEB 
F0 


Section — portic 
SMFDCBOR 


ins of the 
2 


DCB and 

binary 


)EB, including: 
DCBDSORG 


Data set organization being used 


242 


F2 


SMFDCBRF 


1 


binary 


DCBRECFM 


Record format 


243 


F3 


SMFDCBMF 


2 


binary 


DCBMACRF 


Type of I/O macro instruction and options 


245 


F5 


SMFDCBFL 


1 


binary 


DCBOFLGS 


Indicator used by the OPEN routine such as the type of the 
last I/O operation, and the return from the user's exit. 


246 


F6 


SMFDCBOP 


1 


binary 


DCBOPTCD 


Option codes used by access-method interfaces 


247 


F7 


SMF14RV2 


1 


binary 




Reserved 


248 


F8 


SMFDEBFL 


1 


binary 


DEBOFLGS 


Data set and device status indicator. This field indicates 
whether a data set is modified, new or old, and shows the 
status of DASD. 


249 


F9 


SMFDEBOP 


1 


binary 


DEBOPATB 


Indicator showing both the method of I/O processing and 
the disposition that is to be performed when an end-of- 
volume (EOV) condition occurs. 


250 


FA 


SMFDEBVL 


2 


binary 


DEBVLSEQ 


Volume sequence number. For direct access, the sequence 
number is relative to the first volume of the data set. For 
tape, the sequence number is relative to the first volume 
processed. 
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Offsets 



Name 



Length Format 



Source 



Description 



1 

For each DCB/DEB tape extension, there is a 12-byte entry with the following format: 

+0 SMFDCBBL 4 binary DCBBLKCT Block count for each volume 

+4 SMFDSSNO 6 binary UCBSQC Data set serial number 

+10 SMF14RV3 2 binary Reserved 



The following 12 bytes apply to the DCB/DEB DASD extension: 



+0 



+4 
+8 
+9 



SMF14NTU 



SMF14NTR 
SMF14NER 
SMF14RV4 



binary 



binary 
binary 
binary 



DCBFDAD 



TCTTKRLD 
TCTEXRLD 



Relative track and concatenation number (TTRN) of the 
last record processed for a physical sequential or partitioned 
data set. N is always zero except for BPAM-concatenated 
data sets. If the last operation was a read (DCBOFLGS 
bit is off) the TTR is: (1) zero, (2) the start of a BPAM 
member if there are two or more lOBs, or (3) the last write 
of the data set if there is one IOB. This is true because the 
access method maintains DCBFDAD while reading only if 
RECFM=FS, RECFM=FBS, or only one IOB (BUFNO, 
NCP) is used. 

Number of tracks released by the DADSM routine 

Number of extents released by the DADSM routine 

Reserved 



UCB Section — a portion of the UCB (see offsets 41 and 42), including: 



+0 

+1 
+2 
+8 
+12 

+13 
+14 
+16 



SMFUCBCH 


1 


binary 


SMFUCBUA 


1 


binary 


SMFSRTEV 


6 


binary 


SMFUCBTY 


4 


binary 


SMFSRTES 


1 


binary 


SMF14NEX 


1 


binary 


SMF14RV5 


2 


binary 


SMFEXCP 


4 


binary 



UCBCHA 

UCBUA 
UCBVOLI 
UCBTYP 
UCBSTAB 

internal (in DEB) 
TCTDCTR 



Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 

tVoJume i serial number 

Unit type 

DASD volume status indicator. This field indicates whether 
this DASD volume is a private, public, storage, or control 
volume. 

Number of extents 

Reserved 

EXCP count for entire step. Note that if a data set is 
opened and closed twice during a single step, the count in 
the second type 14 record is the sum of all EXCPs for both 
uses of the data set. (The EXCP count in the last type 14 
record for the step is equal to the corresponding entry for 
the data set in record type 4. For more information about 
EXCP count, see record type 4.) 



For each UCB tape extension, there is a four-byte entry with the following format: 



+0 
+2 



SMFSRTEF 
SMFSRTEQ 



binary 
binary 



UCBFSCT 
UCBFSEQ 



The following four bytes apply to the UCB DASD extension: 



+0 



SMF14NTA 



4 



binary 



DEBNMTRKfor 
all extents 



Data set sequence count 
Data set sequence number 

Number of tracks allocated on the device 



ISAM Extension Section (DCBDSORG=IS and DCBMACRF not EXCP): 

+0 
+2 



+3 
+4 

+8 
+12 



SMF14RV6 


2 


binary 


SMFDCBMA 


1 


binary 


SMFDCBNL 


1 


binary 


SMFDCBR3 


4 


binary 


SMFDCBNR 


4 


binary 


SMFDCBR2 


2 


binary 



DCBMAC 

DCBNLEV 
DCBRORG3 

DCBNREC 
DCBRORG2 



Reserved 

Extension of I/O macro instruction field (DCBMACRF) 
for ISAM 

Number of index levels 

For each use of the data set, number of read or write 
accesses to an overflow record which is not first in a chain 
of such records 

Number of logical records in the prime data area 

Number of tracks (whole or partial) remaining in the 
overflow area 
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Offsets Name 


Length 


Format 


Source 


Description 


i 1 
ISAM Extension Section: (Continued) 






+14 




SMFDCBNO 


2 


binary 


DCBNOREC 


Number of logical records in the overflow area 


+16 




SMFDCBR1 


2 


binary 


DCBRORG1 


Number of cylinder overflow areas that are full 


+ 18 




SMF14RV7 


1 


binary 




Reserved 


+19 




SMFDEBNI 


1 


binary 


DEBNIEE 


Number of extents in the independent index area 


+20 




SMFDEBNP 


1 


binary 


DEBNPEE 


Number of extents in the prime data area 


+21 




SMFDEBNO 


1 


binary 


DEBNOEE 


Number of extents in the independent overflow area 


+22 




SMFNCYLS 


2 


binary 


internal (in DEB) 


Number of cylinders in the independent index area 


+24 




SMFNPCYL 


2 


binary 


internal (in DEB) 


Number of cylinders in the prime data area 


+26 




SMFNOCYL 


2 


binary 


internal (in DEB) 


Number of cylinders in the independent overflow area 
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Record Type 15 - OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity 

Record type 15 is written for non-VSAM direct access or tape data sets that are 
defined by DD statements and opened for OUTPUT, UPDAT, INOUT, or OUTIN 
processing by problem programs. It is written by IFG0202H and IFG0202I when 
a data set, as described above, is closed or processed by EOV. Its length varies 
from 288 to 6,412 bytes, depending upon the number of volumes for the data set. 

This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see OS/VS1 System Data 
Areas. 

Note: Record type 15 is not written for data sets defined as SYSOUT data sets on 
DD statements. For accounting purposes, the SYSOUT logical record count is 
provided in record type 6. 

The format for this record is the same as the format for record type 14. 
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Record Type 17 - Scratch Data Set Status 

Record type 1 7 is written by IGG0290D when a non-VSAM data set that is defined 
by a DD statement (either explicitly or implicitly) is scratched. (When a DD 
statement defines a volume, all the data sets on that volume are implicitly defined.) 
This record contains the data set name, number of volumes, and volume serial 
numbers. Its length is 88 bytes plus eight bytes for each volume. 

Notes: 

1 . If REC=0 was specified, record type 17 is generated for non-temporary data sets 
only. If REC=2 was specified, this record is generated for both temporary and 
non-temporary data sets. 

2. The length of this record can vary from 96 to 2,136 bytes, depending upon the 
number of volumes for the data set. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF17FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF17RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF17TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF17DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF17SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF17JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF17RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF17RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 1 


30 


1E 


SMF17UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF17RIN 


2 


binary 




Reserved 


40 


28 


SMF17DSN 


44 


EBCDIC 


user's parameter list 


Data set name 


84 


54 


SMF17RV1 


3 


binary 




Reserved 


87 


57 


SMF17NVL 


1 


binary 


user's parameter list 


Number of volumes 


Fore 
+0 

+2 


ach vo 


ume, there is a e 
SMF17RV2 
SMF17FVL 


ight-byte 
2 
6 


entry with 
binary 
EBCDIC 


i the following format 
user's parameter list 


Reserved 

Volume serial number 



■"•The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 1 8 — Rename Data Set Status 

Record type 18 is written by IGG03001 when a non-VSAM data set that is defined 
by a DD statement (either explicitly or implicitly) is renamed. (When a DD 
statement defines a volume, all the data sets on that volume are implicitly defined.) 
This record contains the old data set name, new data set name, number of volumes, 
and volume serial numbers. Its length is 132 bytes plus eight bytes for each volume. 



| 



Note: The length of this record can vary from 140 to 2,180 bytes, depending upon 
the number of volumes for the data set. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF18FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF18RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF18TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF18DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF18SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF18JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF18RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


26 


1A 


SMF18RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF18UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF18RIN 


2 


binary 




Reserved 


40 


28 


SMF180DS 


44 


EBCDIC 


user's parameter list 


Old data set name 


84 


54 


SMF18NDS 


44 


EBCDIC 


user's parameter list 


New data set name 


128 


80 


SMF18RV1 


3 


binary 




Reserved 


131 


83 


SMF18NVL 


1 


binary 


user's parameter list 


Number of volumes 


For e 

+0 

+2 


ach vo 


lume, there is an 
SMF18RV2 
SMF18FVL 


eight-byt 
2 
6 


e entry wil 
binary 
EBCDIC 


th the following forma 
user's parameter list 


t: 

Reserved 

Volume serial number 



1 The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 1 9 — Direct Access Volume 

Record type 19 is written by IGC0107H (1) for each direct access device that is 
online at IPL, (2) when a HALT EOD or SWITCH SMF command is processed, 
and (3) when a volume that is defined by a DD statement is demounted. Its length 
is 64 bytes. 

This record contains the volume serial number, VTOC address, owner 
identification, unit type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, and 
number of unallocated extents. It also contains the channel address, unit address, 
and module identification for devices having movable address plugs. 

Notes: 

1 . Record type 19 is not produced for DOS volumes used under the VS1 operating 
system. 

2. In order to determine the latest status of a shared file, the CPU clocks must be 
synchronized. 
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The format is: 



( 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF19FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF19RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF19TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF19DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF19SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF19RV1 


2 


binary 




Reserved 


16 


10 


SMF19VOL 


6 


EBCDIC 


1 
volume label 

(VOLSERNO) 


Volume serial number 


22 


16 


SMF190ID 


10 


EBCDIC 


volume label 
(VOLOWNER) 


Owner identification of direct access volume 


32 


20 


SMF19DEV 


4 


binary 


UCBTYP 


Unit type 


36 


24 


SMF19VTC 


5 


binary 


1 
volume label 

(VOLVTOC) 


VTOC address 


41 


29 


SMF19VTI 


1 


binary 


DS4VTOCI 
(in DSCB4) 

DS4DIRF 
DS4DICVT 


VTOC indicator 

Bit Meaning When Set 

0-4 Reserved 

5 Possible VTOC error 

6 VTOC error has been fixed 

7 Reserved 


42 


2A 


SMF19NDS 


2 


binary 


internal 


Number of DSCBs, calculated as: number of DSCBs per 
track times number of tracks in VTOC 


44 


2C 


SMF19DSR 


2 


binary 


DS4DSREC 
<inDSCB4) 


Number of DSCBOs, that is, number of available DSCBs 


46 


2E 


SMF19NAT 


2 


binary 


DS4NOATK 
(in DSCB4) 


Number of unused alternate tracks 


48 


30 


SMF19SPC 


2 


binary 


internal (DSCB5) 


Number of unallocated cylinders 


50 


32 




2 


binary 


internal (DSCB5) 


Number of unallocated tracks 


52 


34 


SMF19LEX 


2 


binary 


internal (DSCB5) 


Number of cylinders in the largest unallocated extent 


54 


36 




2 


binary 


internal (DSCB5) 


Number of tracks in the largest unallocated extent 


56 


38 


SMF19NUE 


2 


binary 


internal (DSCB5) 


Number of unallocated extents 


58 


3A 


SMF19RV2 


2 


binary 




Reserved 


60 


3C 


SMF19CUU 


1 


binary 


UCBCHA 


Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 


61 


3D 




1 


binary 


UCBUA 


Unit address 


62 


3E 


SMF19IND 


2 


binary 


internal 


Module identification or drive number indicating physical 
identity of devices having moveable address plugs. This 
field is taken from bits 2-7 of sense byte 4 for these 
devices. (See the component descriptions of these devices 
for the meaning of sense byte 4.) 



■'The volume label for the direct access device is record 3 of cylinder of track 0. 
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Record Type 20 — Job Initiation 

Record type 20 is written by IEFSMFIE at job initiation. This record contains the 
job log identification, user identification, programmer's name, number of accounting 
fields on the JOB statement, and accounting fields. Its length is 61 bytes plus the 
length of the JOB statement accounting fields. 

Note: If the IEFUIV user-written exit routine cancels a job, the SMF data set will 
contain a record of the job only if the IEFUIV routine writes it. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF20FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF20RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF20TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF20DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF20SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF20JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF20RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF20RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF20UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF20RIN 


2 


binary 




Reserved 


40 


28 


SMF20PGM 


20 


EBCDIC 


ACTPRGNM (in JCT) 


Programmer's name 


60 


3C 


SMF20NAF 


1 


binary 


ACTJNFLD (in JCT) 


Number of accounting fields 


61 


3D 


SMF20ACT 


variable 


EBCDIC 


JOB statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 



1 The job name and the time and date that the reader recognized the 
JOB card for this job constitute the job log identification. 
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Record Type 21 — Error Statistics by Volume 

Record type 21 is written by IGC0009A when a user data set on magnetic tape is 
closed or processed by end-of-volume (EOV). Its length is 44 bytes. 

This record contains the volume serial number, channel address, unit address, 
unit type, and tape density. It also contains the number of: temporary and 
permanent read and write errors, START I/Os, noise blocks, erase gaps, and cleaner 
actions. 



( 



Notes: 



1. 



Record type 21 is written to the SMF data set only when ESV=SMF is specified 
in the SCHEDULR macro instruction at SYSGEN time. 
2. The IFHSTATR utility program formats and prints the error-statistics-by-volume 
(ESV) information in this record. For a detailed description of this utility 
program, see OS/VS1 Utilities. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF21FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF21RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF21TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF21DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF21SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF21LGH 


2 


binary 


internal 


Length of rest of record including this field. (This field is 
always 30.) 


16 


10 


SMF21VOL 


6 


EBCDIC 


UCBVOLI 


Volume serial number y 


22 


16 


SMF21CA 




binary 


UCBCHA 


Channel address 


23 


17 






binary 


UCBUA 


Unit address 


24 


18 


SMF21UCB 


4 


binary 


UCBTYP 


Unit type 


28 


1C 


SMF21TR 




binary 


UCBTR 


Number of temporary read errors 


29 


1D 


SMF21TW 




binary 


UCBTW 


Number of temporary write errors 


30 


1E 


SMF21SIO 


2 


binary 


UCBSIO 


Number of START l/Os / 


32 


20 


SMF21PR 




binary 


UCBPR 


Number of permanent read errors * 


33 


21 


SMF21PW 




binary 


UCBPW 


Number of permanent write errors *' 


34 


22 


SMF21NB 




binary 


UCBNB 


Number of noise blocks 


35 


23 


SMF21ERG 


2 


binary 


UCBERG 


Number of erase gaps 


37 


25 


SMF21CLN 


2 


binary 


UCBCLN 


Number of cleaner actions 


39 


27 


SMF21DEN 


1 


binary 


DCBDEN 

DCBMTDNO 
DCBMTDN1 
DCBMTDN2 
DCBMTDN3 
DCBMTDN4 


Tape density — 2400 and 3400 series magnetic tape units 
Bits Meaning When Set 

Code 7-Track 9-Track 
6,7 200 BPI N/A 
1,6,7 1 556 BPI N/A 
0,6,7 2 800 BPI 800 BPI 
0,1,6,7 3 N/A 1600 BPI 
0,1,3,6,7 4 N/A 6250 BPI 


40 


28 


SMF21BLS 


2 


binary 


DCBBLKSI 


Block size. This field is zero if DCBRECFM indicates 
variable or unblocked records, or if you are doing your own 
EXCP processing. 


42 


2A 


SMF21RV0 


2 


binary 




Reserved (not necessarily zero) 
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Record Type 22 - Configuration 

Record type 22 is written (1) by ICBMSGOO after every IPL of the system, and (2) 
by IGC1 26 when a VARY ONLINE,S or VARY OFFLINE,S operator command 
changes the status of a mass storage device. This record describes the MSS units 
online at IPL, and indicates the subsystem identification (SSID) of each device that 
is varied online or offline. Its length is 18 bytes plus the length of the sections in 
the record. 

Notes: 

1 . During system initialization, the Mass Storage Control (MSC) creates a 
configuration record (called Message 92) and puts it in a message buffer. After 
SMF is initialized, ICBMSGOO creates the "MSS IPL Configuration section" of 
record type 22 from the Message 92 in the MSC buffer. 

2. By using the VARY ONLINE,S and VARY OFFLINE,S commands, the operator 
can modify the configuration. (The formats of these commands are described in 
Operator's Library: IBM 3850 Mass Storage System (MSS) Under OS /VS. ) 

In a record type 22, a "VARY ONLINE ,S section" or a "VARY OFFLINE,S 
section" is written for each unit varied by these commands. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF22FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF22RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF22TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF22DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF22SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF22IND 


2 


binary 


ICBMSGOO 

IGC126 

IGC126 


Record creator indicator 
Value Meaning 

4 MSS at IPL 

5 VARYONLINE.S 

6 VARYOFFLINE,S 


16 


10 


SMF22ECT 


2 


binary 


internal 


Number of sections following 


MSS 

+0 

+1 

Thef 
+2 


PL Co 

□llowi 


nfigu ration Sect 

SMF22RV4 
SMF22IID 

ig 40 bytes cont 
SMF22ION 


ion: 
1 
1 

ain the bil 
1 


binary 
binary 

pattern o 
binary 


internal 
f MSS units online at 


Reserved 

MSS IPL configuration section identification. (This field 
is always 4.) 

IPL: 

Data recording devices (DRDs) of MSF(O) 
Bit SSID 

200 

1 201 

2 202 

3 203 

4 204 

5 205 

6 206 

7 207 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


MSS IPL Configuration Section: (Continued) 








+3 






1 


binary 




Data recording devices (DRDs) of MSF(1) 
Bit SSID 

210 

1 211 

2 212 

3 213 

4 214 

5 215 

6 216 

7 217 




+4 






2 


binary 




Reserved 




+6 






2 


binary 




Staging Adapters 
Bit SSID 

800 

1 810 

2 820 

3 830 

15 8F0 




+8 






1 


binary 




Device recording controls (DRCs) of MSF(0) 
Bit SSID 

400 

1 401 

2 402 

3 403 

Device recording controls (DRCs) of MSF(1) 

4 410 

5 411 

6 412 

7 413 




+9 






1 


binary 




Reserved 




+10 






28 


binary 




Staging spindles in staging data groups (SDGs) 

SDG Bits SSIDs 

0-7 000-007 

1 0-7 008-00F 

2 0-7 010-017 

3 0-7 018-0IF 

27 0-7 0E8-0EF 




+38 






3 


binary 




Reserved 




+41 






1 


binary 




MSF indicator 

Bit Meaning When Set 

MSF(0) withSSIDof 101 

1 MSF(0) withSSIDof 102 

2 MSF(1) withSSIDof 111 

3 MSF(1) withSSIDof 112 
4-7 Reserved 




VARY ONLINE^ Section: 










+0 




SMF22RV5 


1 


binary 




Reserved 




+1 




SMF22NID 


1 


binary 


internal 


VARY ONLINE,S section identification. (This field 
always 5.) 


is 


+2 




SMF22RVA 


1 


binary 




Reserved 




+3 




SMF22NSI 


3 


binary 


VARY command 


Subsystem identification of device 





( 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


VARY OFFLINE,S Section: 










+0 




SMF22RV6 


1 


binary 




Reserved 




+1 




SMF22FID 


1 


binary 


internal 


VARY OFFLINE.S section identification. (This field 
always 6.) 


is 


+2 




SMF22RVB 


1 


binary 




Reserved 




+3 




SMF22FSI 


3 


binary 


VARY command 


Subsystem identification of device 





SMF Records 109 



Record Type 43 - RTAM Start 



\ 



Record type 43 is written by IFSINIT during RTAM initialization. This record 
contains the RTAM start procedure name, maximum number of readers and writers 
supported, number of line and logical port DCTs, and number of lines to start at 
this time. This record also identifies each line DCT created by line number, channel 
address, and unit address. Its length is 42 bytes plus six bytes for each line DCT 
entry. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF43FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF43RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF43TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF43DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF43SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF43SBS 


2 


binary 


internal 


Subsystem identification — X'0001 ' signifies RTAM 


16 


10 




2 


binary 




Reserved 


18 


12 


SMF43LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF43PNM 


8 


EBCDIC 


QIDPROC 


RTAM start procedure name 


28 


1C 




8 


binary 




Reserved 


36 


24 


SMF43RDR 




binary 


RTMRDR 


Maximum number of readers supported 


37 


25 


SMF43WRT 




binary 


RTMPTR + 
RTMPNCH 


Maximum number of writers supported 


38 


26 


SMF43TAB 




binary 


SNUMLNES 
(in IFSSETS) 


Number of entries in LINE table 


39 


27 


SMF43DCT 




binary 


NUMLNDCT + 
RTMPORTS 


Number of line and logical port DCTs 


40 


28 


SMF43ACT 




binary 


RTMPORTS 


Number of logical port DCTs 


41 


29 


SMF43STR 




binary 


I ndicated by message 
IFS102I 


Number of lines to start at this time 


For e 

+0 

+3 


ach lir 


e DCT created, 1 
SMF43LNM 
SMF43UAD 


here is a 
3 
3 


six-byte en 
EBCDIC 
EBCDIC 


try with the following 
DCTDEVN 
UCBNAME 


format: 

Line number 

Channel and unit address, in the form cuu where c is the 
channel and uu is the unit 
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Record Type 44 - RTAM Modify 

Record type 44 is written by IFSCMD when a MODIFY RTAM operator command 
is issued. This record contains the RTAM start procedure name, type of 
modification, and number of lines modified at this time. It identifies each line 
modified by line number, channel address, and unit address; it identifies each user 
modified by user identification. Its length is 30 bytes plus either six bytes for each 
modified line entry or nine bytes for each modified user entry. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF44FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF44RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF44TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF44DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF44SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF44SBS 


2 


binary 


internal 


Subsystem identification — X'0001' signifies RTAM 


16 


10 




2 


binary 




Reserved 


18 


12 


SMF44LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF44PNM 


8 


EBCDIC 


QIDPROC 


RTAM start procedure name 


28 


1C 


SMF44COD 

SMF44STR 

SMF44STP 

SMF44RST 

SMF44VEY 

SMF44VEN 

SMF44SPS 

SMF44USR 

SMF44RCH 


1 


binary 


internal 


MODIFY command type 
Value Meaning 

1 START 

2 STOP 

3 RESTART 

4 VTAM=YES (V=Y) 

5 VTAM=NO (V=N) 

6 STOP=S 

7 STOP=userid 

8 Change remote characteristics 


29 


1D 


SMF44LMD 


1 


binary 


internal 


Number of lines modified at this time 


For e 


ach mc 


>dif ied line, there 


is a six-b 


yte entry with the following fo 


rmat: 


+0 




SMF44LNM 


3 


EBCDIC 


DCTDEVN 


Line number 


+3 




SMF44UAD 


3 


EBCDIC 


UCBNAME 


Channel and unit address, in the form cuu where c is the 
channel and uu is the unit 


For e 


ach mc 


id if ied user, there 


is a nine 


-byte entry with the following 1 


ormat: 


+0 




SMF44PRT 


7 


EBCDIC 


QIDUSRID 


User identification (taken from MODIFY command) 


+7 




SMF44RSV 


1 


EBCDIC 




Reserved 


+8 




SMF44RCN 


1 


binary 


DCTRCHAR 


This field identifies the remote characteristics of the 
specified user after the MODIFY command is complete. 
This field is used only if the MODIFY command type is 8; 
if STOP=userid is used, this field is all zeros. 
Bit Meaning When Set 

Compression (CPRES) is supported 

1 Compaction (CPACT) is supported 

2 Transparency (TRAN) is supported 

3 Horizontal format control (HFC) is 
supported 

4 Workstation is unattended (UNATT) 


, 












5-7 Reserved 
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Record Type 45 - RTAM Stop 

Record type 45 is written by IFSCMD when a STOP RTAM operator command is 
issued and by IFSSTAE when the STOP processing is completed. This record 
contains the RTAM start procedure name, STOP status, and number of lines started 
and logical ports active when the STOP was received. Its length is 31 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF45FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF45RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF45TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF45DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sigh 


10 


A 


SMF45SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF45SBS 


2 


binary 


internal 


Subsystem identification — X'0001' signifies RTAM 


16 


10 




2 


binary 




Reserved 


18 


12 


SMF45LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF45PNM 


8 


EBCDIC 


QIDPROC 


RTAM start procedure name 


28 


1C 


SMF45STP 

SMF45BEG 
SMF45END 


1 


binary 


internal 


STOP command processing indicator 
Value Meaning 

Stop begun 

1 Stop ended 


29 


1D 


SMF45USR 


1 


binary 


RESLGCT2 
(inRESCT) 


Number of lines started when STOP command was 
received 


30 


1E 


SMF45PAS 


1 


binary 


internal 


Number of logical ports active when STOP command was 
received 
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Record Type 47 - RTAM Logon 

Record type 47 is written by IEELGON1 when a valid LOGON record is received 
by RTAM. This record contains the QID entry, passback area, and LOGON record. 
Its length is 1 52 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


•j;? Description 








SMF47FLG 


1 


binary 


SVC 83 


System Indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF47RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF47TME 


4 


binary 


SVC 83 


Time in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF47DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF47SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF47SBS 


2 


binary 


internal 


Subsystem identification — X'0001 ' signifies RTAM 


16 


10 




2 


binary 




Reserved 


18 


12 


SMF47LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF47QID 


48 


binary 


QID table 


QID entry 


68 


44 


SMF47PSB 


4 


binary 


internal 


Passback area - X'8000 0000' signifies a valid LOGON 
record 


72 


48 


SMF47LGN 


80 


EBCDIC 


Command buffer 
built by SVC 34 


LOGON record 
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Record Type 48 - RTAM Logoff 

Record type 48 is written by IFSLOGON when a LOGOFF record is received by 
RTAM. This record contains the QID entry; its length is 68 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF48FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF48RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF48TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF48DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF48SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF48SBS 


2 


binary 


internal 


Subsystem identification — X'0001' signifies RTAM 


16 


10 




2 


binary 




Reserved 


18 


12 


SMF48LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF48QID 


48 


binary 


QID table 


QID entry 
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Record Type 49 - RTAM Integrity 

Record type 49 is written by IFSLOGON and IEELGON1 when an invalid 
LOGON record is received by RTAM. This record contains the QID entry, passback 
area and LOGON record. Its length is 152 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF49FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-6 Reserved 

7 VS1 


1 


1 


SMF49RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF49TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF49DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF49SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF49SBS 


2 


binary 


internal 


Subsystem identification — X'0001' signifies RTAM 


16 


10 




2 


binary 




Reserved 


18 


12 


SMF49LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF49QID 


48 


binary 


QID table 


QID entry 


68 


44 


SMF49PSB 


4 


binary 


internal 


Passback area - X'FFOO 0000' signifies an invalid LOGON 
record 


72 


48 


SMF49LGN 


80 


EBCDIC 


If IFSLOGON, from 
BSC TP buffer or 
SNA session 
parameter area. If 
IEELGON1,from 
command buffer 
built by SVC 34 


LOGON record 



SMF Records 115 



Record Type 50 - ACF/VTAM Tuning Statistics 

Record type 50 maps data useful in adjusting certain ACF/VTAM and NCP sysgen 
and START command variables to improve AGF/VTAM performance. Its length 
is 58 bytes. For additional information, refer to the ACF/VTAM System 
Programmer's Guide listed in the Preface. 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF50FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF50RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF50TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF50DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF50SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF50NME 


8 


EBCDIC 




Name of locally attached intelligent controller 


22 


16 


SMF50DLR 


4 


binary 




Number of TCBs needed for dump-load-restart operation 1 


26 


1A 


SMF50CWR 


4 


binary 




Number of write channel programs 


30 


1E 


SMF50CRD 


4 


binary 


ISTZFADB 


Number of read channel programs 


34 


22 


SMF50ATN 


4 


binary 


ISTZFAAB 


Number of attentions received 


38 


26 


SMF50ATR 


4 


binary 


ISTZFA2B 


Number of times ending status of read channel program 
included ATTN 


42 


2A 


SMF50PUI 


4 


binary 


ISTZFA4F 
ISTZFA4B 


Number of PI Us inbound 


46 


2E 


SMF50PUO 


4 


binary 




Number of PI Us outbound 


50 


32 


SMF50BUF 


4 


binary 


ISTZFA4F 
ISTZFA4B 


Number of buffers used in read channel programs 


54 


36 


SMF50SLD 


4 


binary 


ISTZFA3B 


Number of times a locally attached intelligent controller 
enters slowdown 



1 With the exception of the dump-load-restart TCB count, all values are accumulated in the ICNCB. The counts represent activity 
since the last trace entry. 
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Record Type 51 — Subsystem Data 

Record type 5 1 is for subsystem or user data. Invocation of the IFASMFR macro 
instruction for type 5 1 causes the assembly of a DSECT mapping the standard 
type 51 record header. The DSECT ends with a label that marks the beginning of 
the user's data area. The total record length is variable. 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF51 FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF51 RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF51 TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF buffer 


6 


6 


SMF51 DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 00YYDDDF where 
F is the sign 


10 


A 


SMF51 SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF51 UID 


4 


EBCDIC 


User 


User interface identification 


18 


12 


SMF51 USR 


* 




User 


Beginning of user/subsystem segment. Total record length is variable. 
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Record Type 62 — VSAM Component or Cluster Opened 

Record type 62 is written by IDA0192A and IDA0192S at the successful or 
unsuccessful opening of a VSAM component or cluster. Its length is 138 bytes 
plus ten bytes for each volume listed. 

Record type 62 identifies the VSAM component or cluster and indicates whether 
it was successfully opened. It names the VSAM catalog in which the object is 
defined and the volumes on which the catalog and object are stored. It also 
identifies the job that issued the OPEN macro by job log identification and user 
identification. 

Note: This record is not generated when a system task issues the OPEN macro. 
The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF62FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF62RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF62TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF62DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
O0YYDDDF where F is the sign 


10 


A 


SMF62SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF62JBN 


8 


EBCDIC 


JMRJOB 


Job name 


22 


16 


SMF62RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF62RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF62UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF62IND 


4 


binary 


Set by IDA0192A 
and passed to 
IDA0192S in 
parameter list 


Open status indicator 
Bit Meaning When Set 

Component or cluster was successfully opened 

1 Security violation, that is, invalid password 
2-31 Reserved 


42 


2A 


SMF62CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of the catalog in which the component or cluster is 
defined 


86 


56 


SMF62CVS 


6 


EBCDIC 


UCBVOLI 


Volume serial number of the volume containing the catalog 


92 


5C 


SMF62DNM 


44 


EBCDIC 


JFCBDDNM 


Name of the component or cluster being opened 


136 


88 


SMF62VCT 


2 


binary 


OPEN routine 
calculates from 
VMT entries 


Number of online volumes containing the component or 
cluster. (This field is also the number of ten-byte fields 
that list the volumes.) 


For e 
+0 

+6 


ach or 


lline volume, ther 
SMF62VSR 

SMF62DTY 


e is a ten 
6 

4 


-byte entry 
EBCDIC 

binary 


t with the following f< 
VMTVLSER 

UCBTYP 


armat: 

Volume serial number of the volume containing the 
component or cluster 

Unit type of the volume containing the component or 
cluster 



J The job name and the time and date that the reader recognized the JOB card for this 
job constitute the job log identification. 



118 OS/VS1 System Management Facilities (SMF) 



Record Type 63 - VSAM Entry Defined 

Record type 63 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) (1) is defined by the 
DEFINE Access Method Service command, (2) is altered with new space allocation 
information (that is, when the VSAM end-of-volume (EOV) routine extends the 
entry's object), and (3) is changed by the ALTER Access Method Services 
command. One record type 63 is written for each newly created or altered entry. 
Its length is 132 bytes plus the length of the catalog records required to describe the 
entry. 

Record type 63 identifies the catalog in which the object is defined, gives the 
catalog record for the newly defined object, and, for an alteration, gives the parts 
of the old catalog record before they were altered. It identifies the job by job log 
identification and user identification. 

Note: The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the new and old catalog records (offsets 40 and 42, respectively). 
If this record is to be written to the SMF data set, be sure to include the sizes of 
these catalog records when estimating the additional storage required for the SMF 
buffer and the SMF data sets. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF63FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF63RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF63TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF63DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF63SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF63JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF63RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF63RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF63UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 1 


38 


26 


SMF63FDT 


1 


binary 


VSAM catalog 
record entry type 


Record creator/entry type indicator 
Bit Meaning When Set 

New definition 

1 Altered definition 
2-5 Reserved 

6 Path defined or altered 

7 Alternate index defined or altered 



1 The job name 
constitute the 
job-name and 
contain zeros. 



and the time and date that the reader recognized the JOB card for this job 
job log identification. If a system task caused the record to be written, the 
user-identification fields contain blanks, and the time and date fields 
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Offsets 


Name 


Length 


Format 


Source 


Description 


39 


27 


SMF63TYP 


1 


binary 


VSAM catalog 
record entry type 


Entry type indicator 
Bit Meaning When Set 

VSAM cluster 

1 VSAM data component 

2 VSAM index component 

3 VSAM catalog 

4 Non-VSAM data set 
5-7 Reserved 


40 


28 


SMF63NSZ 


2 


binary 


internal 


Size of new catalog record. (Be sure to include the contents 
of this field when estimating the additional storage 
required by SMF.) 2 


42 


2A 


SMF630SZ 


2 


binary 


internal 


Size of old catalog record. This field contains the size of 
the old records before they were altered. (Be sure to 
include the contents of this field when estimating the 
additional storage required by SMF.) 2 


44 


2C 


SMF63CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the entry is defined 


88 


58 


SMF63ENM 


44 


EBCDIC 


Name field of VSAM 
catalog record 


Entry name 


132 


84 


SMF63NCR 


variable 


binary 


VSAM catalog entry 
records 


New catalog record followed by old catalog record. 2 
For the new catalog record, the complete new entry is 
recorded. For the old catalog record, this field contains 
only those old records that were altered; it shows what 
these records were before they were altered. 



2 A VSAM catalog record is contained in one or more physical catalog records. 
Offsets 40 and 42 are the sums of the sizes of the physical catalog records that 
constitute the total logical VSAM catalog record. Catalog record formats are 
shown in the VS1 VSAM Logic manual cited in the Preface. 



Record Type 64 - VSAM Component or Cluster Status 

Record type 64 is written when (1) a VSAM component or cluster is closed, (2) 
VSAM must switch to another volume to continue to read or write, and (3) there 
is no more space available for VSAM to continue processing. If a cluster is closed, 
one record is written for each component in the cluster. This record is written by 
IDA0192S, IDA0200B, IDA0231B, and IDA0557A. Its length is 250 bytes plus 
26 bytes for each extent. 

Record type 64 indicates why the record was created (a component was closed, 
another volume was switched to, or no additional space was available). It describes 
the device and volume(s) on which the object is stored, and gives the extents of the 
object on the volume(s). It also gives statistics about various processing events that 
have occurred since the object was defined, such as the number of records in the 
data component, the number of records that were inserted, and the number of 
control intervals that were split. This record identifies the job by job log 
identification and user identification. 



Note: This record is not generated for system tasks. 
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The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF64FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF64RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF64TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF64DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF64SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF64JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF64RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


26 


1A 


SMF64RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF64UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF64RIN 


1 


binary 


internal 


Situation indicator 

Bit Meaning When Set 

Component closed 

1 Volume switched 

2 No space available 
3-7 Reserved 


39 


27 


SMF64DTY 


1 


binary 


AMBTYPE 


Indicator of component being processed. 
Bit Meaning When Set 

Data component 

1 Index component 
2-7 Reserved 


40 


28 


SMF64CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of the catalog in which the component is defined 


84 


54 


SMF64DNM 


44 


EBCDIC 


VSAM catalog 
(ENTNAME) 


Name of the component being processed 


128 


80 


SMF64NTR 


2 


binary 


VSAM catalog 
(PRIMSPACfor 
primary allocation; 
SCONSPAC for 
secondary allocation) 


Number of tracks that were requested but could not be 
allocated 


130 


82 


SMF64CHR 


4 


binary 


ARDHRBA 
(in ARDB) 


Highest used relat've byte address (RBA) of the component 


134 


86 


SMF64ESL 


2 


binary 


DEBNMEXT * 26 


Length of extent entry portion of record, excluding this field 


For e 
+0 

+4 

+8 

+14 

+16 


sen exl 


tent, there is a 2 
SMF64FCC 

SMF64TCC 

SMF64VSN 
SMF64CUU 

SMF64IND 


6-byte enl 
4 

4 

6 

1 

1 
2 


ry with th 
binary 

binary 

EBCDIC 
binary 

binary 
binary 


e following format: 
DEBSTRCC 

DEBENDCC 

UCBVOLI 
UCBCHA 

UCBUA 
internal 


Beginning cylinder and track, in the form CCHH where CC 
is the cylinder number and HH is the track number 

Ending cylinder and track, in the form CCHH where CC is 
the cylinder number and HH is the track number 

Volume serial number of the volume containing the extent 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 

Spindle identification 



x The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 



(Continued) 



SMF Records 121 



Offsets 


Name 


Length 


Format 


Source 


Description 


+18 




SMF64UTY 


4 


binary 


UCBTYP 


Unit type 


+22 






4 


binary 




Reserved 


Statistics Section : 2 

Accumulative Statistics from Creation Until the 


Current OPEN: 




+0 




SMF64SLN 


4 


binary 


internal 


Length of the statistics section, including this field 


+4 




SMF64NIL 


4 


binary 


AMDNIL 


Number of levels in the index 


+8 




SMF64NEX 


4 


binary 


AMDNEXT 


Number of extents 


+12 




SMF64NLR 


4 


binary 


AMDNLR 


Number of records in the component 


+16 




SMF64NDE 


4 


binary 


AMDDELR 


Number of records that were deleted from the component 


+20 




SMF64NIN 


4 


binary 


AMDIREC 


Number of records that were inserted into the component 


+24 




SMF64NUP 


4 


binary 


AMDURR 


Number of records that were updated in the component 


+28 




SMF64NRE 


4 


binary 


AMDRETR 


Number of records that were retrieved from the component 


+32 




SMF64NFS 


4 


binary 


AMDFSCA 


Number of unused control intervals in the component 


+36 




SMF64NCS 


4 


binary 


AMDNCIS 


Number of control intervals that were split in the 
component 


+40 




SMF64NAS 


4 


binary 


AMDNCAS 


Number of control areas that were split in the component 


+44 




SMF64NEP 


4 


binary 


AMDEXCP 


Number of EXCPs. (For more information about EXCP 
count, see record type 4.) 


Change in Statistics from OP 


EIM toTi 


me of EOV 


and CLOSE: 




+48 




SMF64DIL 


4 


binary 


AMDNIL 


Change in number of levels in the index 


+52 




SMF64DEX 


4 


binary 


AMDNEXT 


Change in number of extents 


+56 




SMF64DLR 


4 


binary 


AMDNLR 


Change in number of records in the component 


+60 




SMF64DDE 


4 


binary 


AMDDELR 


Change in number of records that were deleted from the 
component 


+64 




SMF64DIN 


4 


binary 


AMDIREC 


Change in number of records that were inserted into the 
component 


+68 




SMF64DUP 


4 


binary 


AMDUPR 


Change in number of records that were updated in the 
component 


+72 




SMF64DRE 


4 


binary 


AMDRETR 


Change in number of records that were retrieved from the 
component 


+76 




SMF64DFS 


4 


binary 


AMDFSCA 


Change in number of unused control intervals in the 
component. (This field may be negative.) 


+80 




SMF64DCS 


4 


binary 


AMDNCIS 


Change in number of control intervals that were split 
in the component 


+84 




SMF64DAS 


4 


binary 


AMDNCAS 


Change in number of control areas that were split in the 
component 


+88 




SMF64DEP 


4 


binary 


AMDEXCP 


Change in number of EXCPs. (For more information about 
EXCP count, see record type 4.) 


Data Set Characteristics Sect 


ion: 








+92 




SMF64DBS 


4 


binary 


LPMBLKSZ 
(in IDALPMB) 


Physical block size 


+96 




SMF64DCI 


4 


binary 


AMDCINV 
(inAMDSB) 


Control interval size 


+100 




SMF64DLS 


4 


binary 


AMDLRECL 
(inAMDSB) 


Maximum logical record size 


+104 




SMF64DKL 


2 


binary 


AMDKEYLN 
(in AMDSB) 


Key length 


+106 




SMF64DDN 


8 


EBCDIC 


TIOEDDNM 


DD name. When the record is written for a VSAM catalog 
or catalog recovery area, this field may contain zeros. When 
the record is written for a volume switch or no space 
available condition, and the volume is associated with a 
concatenated TIOT entry, this field contains blanks. 



2 AII the fields in this section are present and are taken from the AMDSB 
data area; inapplicable fields contain zeros. 
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Record Type 67 - VSAM Entry Deleted 

Record type 67 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is deleted. A type 63 
record is written for each entry affected by the DELETE Access Method Services 
command. For example, three records are written for an indexed cluster: one for 
the relationship between the components of the cluster, one for the data component, 
and one for the index component. Its length is 130 bytes plus the length of the 
catalog records required to describe the entry. 

Record type 67 identifies the deleted entry, the VSAM catalog in which the entry 
was defined, and the deleted catalog records. It identifies the job by job log 
identification and user identification. 

Note: The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the catalog records that describe the entry (offset 128). If this 
record is to be written to the SMF data set, be sure to include the sizes of these 
catalog records when estimating the additional storage required for the SMF buffer 
and the SMF data sets. 



The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF67FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF67RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF67TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF67DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF67SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF67JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF67RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF67RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF67UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF67FDT 


1 


binary 


VSAM catalog 
record entry type 


Record creator/entry type indicator 
Bit Meaning When Set 

Uncataloged 2 

1 Scratched 2 
2-5 Reserved 

6 Path deleted 

7 Alternate index deleted 



1 The job name and the time and date that the reader recognized the JOB card for 
this job constitute the job log identification. If a system task caused the record to 
be written, the job-name and user-identification fields contain blanks, and the time 
and date fields contain zeros. 

2 Both indicators are set for VSAM component or cluster entries. For all other VSAM 
entries, only the uncataloged bit is set. For non-VSAM entries, the uncatalog bit is 
always set and the scratched bit is set if the physical non-VSAM space was deleted. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


39 


27 


SMF67IOD 


1 


binary 


VSAM catalog 
record entry type 


Entry type indicator 
Bit Meaning When Set 

VSAM cluster 

1 VSAM data component 3 

2 VSAM index component 3 

3 VSAM catalog 

4 Non-VSAM data set 
5-7 Reserved 


40 


28 


SMF67CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the entry was defined 


84 


54 


SMF67DEN 


44 


EBCDIC 


Name field of VSAM 
catalog record 


Entry name 


128 


80 


SMF67RSZ 


2 


binary 


internal 


Size of catalog record that defined the entry. 4 (Be sure to 
include the contents of this field when estimating the 
additional storage required by SMF.) 


130 


82 


SMF67CRC 


variable 


binary 


VSAM catalog 
entry records 


Catalog record 4 



"'A data or index component can only be deleted as one of the three catalog 
records deleted when a cluster is deleted. 

4 A VSAM catalog record is contained in one or more physical catalog records. 
Offset 1 28 is the sum of the sizes of the physical catalog records that constitute 
the total logical VSAM catalog record. Catalog record formats are shown in the 
OS/VS1 VSAM Logic manual cited in the Preface. 
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Record Type 68 — VSAM Entry Renamed 

Record type 68 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is renamed using the 
ALTER Access Method Services command. This record identifies the VSAM catalog 
in which the object is defined, and gives the old and new names for the object. It 
also identifies the job by job log identification and user identification. Its length is 
170 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF68FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF68RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF68TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF68DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF68SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF68JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF68RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF68RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF68UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 1 


38 


26 


SMF68CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the entry is defined 


82 


52 


SMF680NM 


44 


EBCDIC 


Pointed to by 
CTGFVENT field in 
IEZCTGFV 
parameter list 


Old name of the entry. (AMS obtains this name from the 
ALTER command.) 


126 


7E 


SMF68NNM 


44 


EBCDIC 


Pointed to by 
CTGNEWNM field 
in IEZCTGPL 
parameter list 


New name of the entry. (AMS obtains this name from the 
ALTER command.) 





1 The job name and the time and date that the reader recognized the JOB card for 
this job constitute the job log identification. If a system task caused the record to 
be written, the job-name and user-identification fields contain blanks, and the time 
and date fields contain zeros. 
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Record Type 69 — VSAM Data Space Defined, Extended, or Deleted 

Record type 69 is written by IGGOCLBV when a VSAM data space is defined, 
extended, or deleted using the DEFINE or DELETE Access Method Services 
commands. Record type 69 is not written when a catalog or a unique data set is 
defined or deleted. Its length is 102 bytes. 

This record identifies the catalog in which the data space is defined and the 
volume on which it is (or was) allocated. It also gives the number of free data 
space extents and the amount of unallocated space on the affected volume after 
the definition, extension, or deletion. It identifies the job by job log identification 
and user identification. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF69FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF69RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF69TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF69DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF69SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF69JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF69RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF69RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


IE 


SMF69UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 1 


38 


26 


SMF69CUU 


1 


binary 


UCBCHA 


Channel address 


39 


27 




1 


binary 


UCBUA 


Unit address 


40 


28 


SMF69IND 


2 


binary 


EXCP of sense data 


Spindle identification 


42 


2A 


SMF69NDS 


2 


binary 


VSAM catalog 
volume entry 


Number of free data space extents on the affected volume 
after the data space is defined, extended, or deleted 


44 


2C 


SMF69NUC 


2 


binary 


VSAM catalog 
volume entry 


Number of unallocated cylinders in all of the data spaces 
on the volume 


46 


2E 


SMF69NUT 


2 


binary 


VSAM catalog 
volume entry 


Number of unallocated tracks in all of the data spaces on 
the volume in addition to the number of unallocated 
cylinders 


48 


30 


3MF69LNC 


2 


binary 


VSAM catalog 
volume entry 


Number of cylinders in the largest continuous unallocated 
area in any data space on the volume 


50 


32 


SMF69LNT 


2 


binary 


VSAM catalog 
volume entry 


Number of tracks (in addition to the number of cylinders) 
in the largest continuous unallocated area in any data space 
on the volume 


52 


34 


SMF69CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the data space is defined 


96 


60 


SMF69VSR 


6 


EBCDIC 


Name field of VSAM 
catalog volume entry 


Volume serial number of the volume on which the data 
space is defined 



1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log identification. If a system task caused the record to be written, the 
job-name and user-identification fields contain blanks, and the time and date fields con- 
tain zeros. 
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Record Type 82 — Security 



Record type 82 is a security record used to record information about the events 
and operations of the Programmed Cryptographic Facility, Program Number 
5740-XY5. The record length is 41 bytes plus the length of the variable relocate 
sections. 

Record type 82 is written to the SMF data set at the completion of each of the 
following cryptography functions: 

• Initialization. 

The record is written when the Programmed Cryptographic Facility is initialized, 
either when cryptography is started or as a part of the key generator utility 
program. 

• Start. 

The record is written by ICTVKM01 when a START command is issued for 
cryptography. 

• Stop. 

The record is written by ICTVKM01 when a STOP command is issued for 
cryptography. 

• Generation of an operational key. 

If specified in the initialization options for cryptography, ICTVKM04 writes a 
record after processing each GENKEY macro instruction. 

• Transformation of an operational key. 

If specified in the initialization options for cryptography, ICTVKM04 writes 
the record after processing each RETKEY macro instruction. 

• Execution of the key generator utility. 

The record is written by ICTVKGOO after the execution of the key generator 
utility program, thus providing a record of changes to the cryptographic key 
data set (CKDS). 

Record type 82 consists of a header section and five possible relocate sections. 
The header section identifies the job and step name of the cryptography user, the 
cryptography function that the record describes, and the return code issued by the 
function. The header section is 41 bytes long. 

The five possible variable relocate sections are: 

• Key generator utility, which indicates changes made by the utility to the host 
system master key, the local keys, the cross keys, and the remote keys. The 
length of the section is 6 bytes. 

• GENKEY function, which indicates the action taken in response to a GENKEY 
macro instruction. The length of the section is 27 bytes. 

• RETKEY function, which indicates the action taken in response to a RETKEY 
macro instruction. The length of the section is 1 1 bytes. 

• Cryptography initialization, which describes the SMF recording options in 
effect at initialization and the cryptography function and key manager user 
SVC numbers. The length of the section is 7 bytes. 

• Installation data, which contains any information supplied by an installation 
user exit routine. The maximum length of the section is 66 bytes. 
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Note: The number of relocate sections depends on the type of action taken. For 
instance, the record written when the Programmed Cryptographic Facility stops 
consists only of the header section. When the Programmed Cryptographic 
Facility has previously been initialized within the same IPL, the record written 
when cryptography starts also consists of only the header section. The number of 
relocate sections is indicated in CRY82VCT(offset 37). 

Using the ICTSMF82 and ICTCRY82 macros: Because record type 82 cannot be 
mapped using the IFASMFR macro, you must use two mapping macros to 
symbolically address record type 82. The macros are supplied on SYS1.MACLIB. 
ICTSMF82 maps the fields in record type 82 whose names start with SMF. For 
the Programmed Cryptographic Facility, ICTSMF82 maps the fields addressed by 
offsets X'O' through X'12'. ICTCRY82 maps the fields in record type 82 whose 
names start with CRY. For the Programmed Cryptographic Facility, ICTCRY82 
maps the fields addressed by offsets X'14' through X'28' and the variable 
relocate sections. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 





SMF82FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 1 


SMF82RTY 


1 


binary 


internal 


Record type 


2 2 


SMF82TME 


4 


binary 


SVC 1 1 or 
SVC 83 


Time, in hundredths of a second, record was moved to the SMF 
buffer 


6 6 


SMF82DTE 


4 


packed 


SVC 11 or 
SVC 83 


Date record was moved to the SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 A 


SMF82SID 


4 


EBCDIC 


JMRCPUIDor 
SMCASID 


System identification (taken from SID parameter) 


14 E 


SMF82LNG 


4 


binary 


internal 


Length of record header 


18 12 


SMF82TID 


2 


binary 


internal 


Security product identifier: X'0001' for Programmed 
Cryptographic Facility (Program number 5740-XY5) 


20 14 


CRY82USR 


8 


EBCDIC 


TIOCNJOB 
inTIOT 


Jobname 


28 1C 


CRY82GRP 


8 


EBCDIC 


TIOCSTEP 
inTIOT 


Stepname 


36 24 


CRY82FLG 


1 


binary 


internal 


Reserved 


37 25 


CRY82VCT 


2 


binary 


internal 


Number of variable relocate sections 


39 27 


CRY82FTN 


1 


binary 


internal 


Function code 
Code Meaning 

1 Key generator 

2 GENKEY function 

3 RETKEY function 

4 Start cryptography 

5 Stop cryptography 


40 28 


CRY82RTC 


1 


binary 


internal 


Return code issued by function or X'FF' if function terminated 
abnormally 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description | 


Key Generator Utility Relocate Section: 


+0 


CRY82DTP 


1 


binary 


ICTVKG00 


Data type indicator: X'01' for key generator utility 


+1 


CRY82DLN 


1 


binary 


I.CTVKG00 


Length of the data that follows 


+2 


CRY82SMK 


1 


binary 


ICTVKGOO 


Host system master key flags 

Bit Meaning When Set 

Host system master key was successfully changed 

1-7 Reserved 


+3 


CRY82LMK 


1 


binary 


ICTVKG01 


Local key flags 

Bit Meaning When Set 

At least one local key was updated 

1 At least one local key was added 

2 At least one local key was deleted from the CKDS 
3-7 Reserved 


+4 


CRY82CMK 


1 


binary 


ICTVKG01 


Cross key flags 

Bit Meaning When Set 

At least one pair of cross keys was updated 

1 At least one pair of cross keys was added 

2 At least one pair of cross keys was deleted from the 
CKDS 

3-7 Reserved 


+5 


CRY82RMK 


1 


binary 


ICTVKG01 


Remote key flags 

Bit Meaning When Set 

At least one remote key was updated 

1 At least one remote key was added 

2 At least one remote key was deleted from the CKDS 
3-7 Reserved 


GENKEY Function Relocate Section: 


+0 


CRY82DTP 


1 


binary 


ICTVKM04 


Data type indicator: X'02' for GENKEY function 


+1 


CRY82DLN 


1 


binary 


ICTVKM04 


Length of the data that follows 


+2 


CRY82GFG 


1 


binary 


ICTVKM04 


GENKEY activity flags 
Bit Meaning When Set 

'LOCKEY' parameter was in error 

1 'LOCKEY2' parameter was in error 

2 'REMKEY' parameter was in error 

3 'OPKEY' was generated by the key manager. When 
bit 3 is off, 'OPKEY' was supplied to the key manager. 

4 Installation data relocate section was omitted from this 
record because the data supplied by installation exit 
exceeded the length of CRY82ID (64 bytes). 

5-7 Reserved 


+3 


CRY82LK1 


8 


EBCDIC 


GENKEY 
LOCKEY 
parameter 


'LOCKEY' key name 


+11 


CRY82LK2 


8 


EBCDIC 


GENKEY 

LOCKEY2 

parameter 


'LOCKEY2' key name 


+19 


CRY82REM 


8 


EBCDIC 


GENKEY 
REMKEY 
parameter 


'REMKEY' keyname 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


RETKEY Function Relocate Section: 


+0 


CRY82DTP 


1 


binary 


ICTVKM04 


Data type indicator: X'03' for RETKEY function 


+1 


CRY82DLN 


1 


binary 


ICTVKM04 


Length of the data that follows 


+2 


CRY82RFG 


1 


binary 


ICTVKM04 


RETKEY activity flags 
Bit Meaning When Set 

Installation data relocate section was omitted from this 
record because the data supplied by the installation exit 
exceeded the length of CRY82ID (64 bytes) 

1 -7 Reserved 


+3 


CRY82RKN 


8 


EBCDIC 


RETKEY 
REMKEY 
parameter 


'REMKEY' key name 


Cryptograi 


ihy Initiatizatio 


n Reloca 


te Section: 






+0 


CRY82DTP 


1 


binary 


ICTVKG00 
ICTVKM01 


Data type indicator: X'04' for initialization 


+1 


CRY82DLN 


1 


binary 


ICTVKG00 
ICTVKM01 


Length of the data that follows 


+2 


CRY82SMF 


1 


binary 


ICTOPTNS 


SMF option flags 

Bit Meaning When Set 

SMF records not written for GENKEY function 

1 SMF records not written for RETKEY function 
2-7 Reserved 


+3 


CRY82SIM 


2 


binary 


ICTOPTNS 


Cryptography function user SVC number in the form X'cccc' 


+5 


CRY82KMG 


2 


binary 


ICTOPTNS 


Key manager user SVC number in the form X'cccc' 


Installation Data Relocate Section: 


+0 


CRY82DTP 


1 


binary 


ICTVKG00 
ICTVKM04 


Data type indicator: X'05' for installation data 


+1 


CRY82DLN 


1 


binary 


ICTCKG90 
ICTMGR90 
ICTMGR95 


Length of the data that follows 


+2 


CRY82ID 


VAR 


EBCDIC 


ICTCKG90 
ICTMGR90 
ICTMGR95 


Installation data written by an installation user exit routine. 
The maximum length is 64 bytes. 
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Appendix A: Field-to-Record Cross-Reference 



This appendix lists all of the fields in the SMF records in alphabetical order and 
identifies the record type containing each field. It also gives the displacement of 
the field within the record. 

Some records have sections of fields that are generated only when specific 
events occur, such as when IPL is completed or when a device is varied online or 
offline. The following abbreviations will appear under the "offset" column to 
indicate the section of the record where the field is found : 

ACT Accounting section 

CRYP Cryptography initialization relocate section (5740-XY5) 

DCB DCB/DEB DASD entension entry 

DCT Line DCT and modified line entry 

DEV Device entry 

DSC Data set characteristics section 

EXT Extent entry 

GENK GENKEY relocate section (5740-XY5) 

IDAT Installation data relocate section (5740-XY5) 

ISAM ISAM extension section 

KG Key generator relocate section (5740-XY5) 

MSS MSS IPL configuration section 

PAR Partition entry 

REL Relocate section 

RETK RETKEY relocate section (5740-XY5) 

STAT Statistics section 

TAPD DCB/DEB tape extension entry 

TAPU UCB tape extension entry 

UCB UCB section 

VAR VARY ONLINE,S and VARY OFFLINE,S section 

VOL Volume entry 

VTAM Modified VTAM user entry 



Appendix A: Field-to-Record Cross-Reference 131 



Field Description 

Access-method interfaces option codes 

Accounting fields, job 

Accounting fields, step 
Address. VTOC 
Allocation, device start time 
Allocation status indicator 

Alternate tracks, number of unused 
Attentions received, number of 
Beginning cylinder and track 
Block count volume 

Block size 

BTSS indicator 

BUF parameter 

Buffer, date record was moved to 

Buffer, number of bytes in 

Buffer, time record was moved in 

Buffers used in read channel programs, number of 

Card-image records in DD DATA and DD* data sets read for 
step/job 

Catalog name 



Catalog record size 

Catalog records 

CCHH, beginning 
CCHH, ending 



Record 


Offset 


Type 


Dec. 


Hex. 


14 


246 


F6 


15 


246 


F6 


5 


117 


75 


20 


61 


3D 


4 


ACT 




19 


36 


24 


4 


86 


56 


14 


63 


3F 


15 


63 


3F 


19 


46 


J2E 


50 


34 


22 


64 


EXT 




14 


TAPD 




15 


TAPD 




21 


40 


28 


64 


DSC 




6 


98 


62 





18 


12 


ALL 1 


6 


6 





18 


12 


ALL 1 


2 


2 


50 


50 


32 


4 


47 


2F 


5 


47 


2F 


62 


42 


2A 


63 


44 


2C 


64 


40 


28 


67 


40 


28 


68 


38 


26 


69 


52 


34 


63 


40 


28 


63 


42 


2A 


67 


128 


80 


63 


132 


84 


67 


130 


82 


64 


EXT 




64 


EXT 
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Field Description 
Channel address 



Class, job 

Class, SYSOUT 

Classes, number of job 
Cleaner actions, number of 
Completion code, job 
Completion code, step 
Component indicator 
Component or cluster name 

Continuous wait time limit 

Control areas, number that were split 

Control interval size 

Control intervals, number of unused 
Control intervals, number that were split 
Copies distribution 
Copies flashed, number of 
Copy modification module name 
CPU time 

Cylinder overflow areas that are full, number of 

Cylinders, number of unallocated 

Cylinders in independent index, prime data, and independent 
overflow areas, number of 

Cylinders in largest continuous unallocated area, number of 

Cylinders in largest unallocated extent, number of 

DASO volume status indicator 



Record 


Offs 


«t 


Type 


Dec. 


He: 


4 


DEV 




8 


DEV 




9 


DEV 




10 


DEV 




11 


DEV 




14 


UCB 




15 


UCB 




19 


60 


3C 


21 


22 


16 


43 


DCT 




44 


DCT 




64 


EXT 




69 


38 


26 


5 


71 


47 


13 


PAR 




5 


63 


3F 


6 


38 


26 


13 


PAR 




21 


37 


25 


5 


51 


33 


4 


51 


33 


64 


39 


27 


62 


92 


5C 


64 


84 


54 





14 


E 


64 


STAT 




64 


DSC 




64 


STAT 




64 


STAT 




6 


65 


41 


6 


97 


61 


6 


89 


59 


4 


ACT 




5 


113 


71 


14 


ISAM 




15 


ISAM 




19 


48 


30 


69 


44 


2C 


14 


ISAM 




15 


ISAM 




69 


48 


30 


19 


52 


34 


14 


UCB 




15 


UCB 
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Field Description 

Data set indicator 



Data set name 

Data set organization 

Data set sequence count 

Data set sequence number 

Data set serial number 

Data sets processed by writer, number of 
Data space extents, number of free 
Date initiator selected step/job 

Date job terminated 

Date reader recognized end of job 

Date reader recognized the JOB card 



Date record was moved to dump data set 

Date record was moved to SMF buffer 

Date recording was started when SMF data set became available 

Date step terminated 

Date SYSOUT was started 

DD DATA and DD* data set records read for step/job 

DD entry length 

DD name 



Record 


Offs 


et 


Type 


Dec. 


Hex. 


14 


38 


26 


14 


51 


33 


14 


248 


F8 


15 


38 


26 


15 


51 


33 


15 


248 


F8 


17 


40 


28 


18 


40 


28 


18 


84 


54 


14 


240 


F0 


15 


240 


F0 


14 


TAPU 




15 


TAPU 




14 


TAPU 




15 


TAPU 




14 


TAPD 




15 


TAPD 




6 


52 


34 


69 


42 


2A 


4 


43 


2B 


5 


43 


2B 



58 



3A 



4 


26 


1A 


5 


26 


1A 


6 


26 


1A 


10 


26 


1A 


14 


26 


1A 


15 


26 


1A 


17 


26 


1A 


18 


26 


1A 


20 


26 


1A 


62 


26 


1A 


63 


26 


1A 


64 


26 


1A 


67 


26 


1A 


68 


26 


1A 


69 


26 


1A 


2 


6 


6 


3 


6 


6 


ALL 1 


6 


6 


7 


20 


14 


4 


6 


6 


6 


43 


2B 


4 


47 


2F 


5 


47 


2F 


14 


48 


30 


15 


48 


30 


14 


52 


34 


15 


52 


34 


64 


DSC 
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Field Description 

Deleted records, number of 

Density, tape 

Device allocation requests, number of 

Device class 



Device indicator 

Device recording controls, MSF 

Device SS ID 

Devices, MSF data recording 

Devices requested during allocation, number of 

Device allocation start time 

Drive number 

DSCBs, number of 

DSCBOs, number of 

Dump data set, date record was moved to 

Dump data set, time record was moved to 

End-of -volume indicator 

Ending cylinder and track 

Ending status of read channel program, number of 
times ATTN included 

Entries in LINE table, number of 

Entry name 

Entry type indicator 

Erase gaps, number of 
EXCP count 



Record 


Offs 


et 


Type 


Dec. 


He> 


64 


STAT 




21 


39 


27 


14 


50 


32 


15 


50 


32 


4 


DEV 




5 


69 


45 


8 


DEV 




9 


DEV 




10 


DEV 




11 


DEV 




14 


51 


33 


14 


248 


F8 


15 


51 


33 


15 


248 


F8 


22 


MSS 




22 


VAR 




22 


MSS 




14 


50 


32 


15 


50 


32 


4 


86 


56 


19 


62 


3E 


19 


42 


2A 


19 


44 


2C 


2 


6 


6 


3 


6 


6 


2 


2 


2 


3 


2 


2 


14 


249 


F9 


15 


249 


F9 


64 


EXT 




50 


38 


26 



43 



38 



26 



63 


88 


58 


67 


84 


54 


68 


82 


52 


68 


126 


7E 


63 


38 


26 


63 


39 


27 


67 


38 


26 


67 


39 


27 


21 


35 


23 


4 


DEV 




14 


UCB 




15 


UCB 




64 


STAT 
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Field Description 

Expiration time of ten-minute intervals 

Extents, number of 

Extents, number of unallocated 

Extents in independent index, prime data, and independent 
overflow areas, number of 

Extents released by DADSM routine, number of 

Flash overlay name 
Form number 

GENKEY flags 
GENKEY key name 

Highest used relative byte address 

I/O processing method indicator 

I/O status 

Index levels, number of 

Initiator select date for step/job 
Initiator select time for step/job 

^" , Input class for job 

Input/output {see I/O) 
Inserted records, number of 
Intelligent controller name 
JFCB 

JFCB TTR address 

Job accounting fields 

^^v Job class 

Job classes, number of 
Job completion code 
^^^i Job CPU time 

2 Programmed Cryptographic Facility (5740-XY5) 



Record 


Offset 


Type 


Dec. 


Hes 


1 


18 


12 


12 


18 


12 


14 


UCB 




15 


UCB 




64 


STAT 




19 


56 


38 


14 


ISAM 




15 


ISAM 




14 


DCB 




15 


DCB 




6 


93 


5C 


6 


53 


35 


82 


GENK 2 




82 


GENK 2 




64 


130 


82 


14 


249 


F9 


15 


249 


F9 


6 


51 


33 


14 


ISAM 




15 


ISAM 




64 


STAT 




4 


43 


2B 


5 


43 


2B 


4 


39 


27 


5 


39 


27 



1 



71 



47 



64 


STAT 




50 


14 


E 


14 


64 


40 


15 


64 


40 


14 


60 


3C 


15 


60 


3C 


5 


117 


75 


20 


61 


3D 


5 


71 


47 


13 


PAR 




13 


PAR 




5 


51 


33 


5 


113 


71 
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Field Description 

Job log identification 



Job name 



— ■ — * Job priority 

Job termination date 

Job termination indicator 
— i m Job termination time 
«n f— » Job wait time limit 

JWT parameter 

Key, storage protect 

Key length 
Length of DD entry 

Length of security record header 
Limit, continuous wait time 
Line DCTs, number of 
Line number 

LINE table entries, number of 

Lines modified, number of 

Lines started when STOP was received, number of 

2 Programmed Cryptographic Facility (5740-XY5) 



Record 


Offset 


Type 


Dec. 


Hex. 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 


18 


14 


E 


20 


14 


E 


62 


14 


E 


63 


14 


E 


64 


14 


E 


67 


14 


E 


68 


14 


E 


69 


14 


E 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 


18 


14 


E 


20 


14 


E 


62 


14 


E 


63 


14 


E 


64 


14 


E 


67 


14 


E 


68 


14 


E 


69 


14 


E 


82 


202 




5 


53 


35 


5 


6 


6 


5 


62 


3E 


5 


2 


2 





14 


E 





14 


E 


4 


82 


52 


5 


72 


48 


64 


DSC 




14 


48 


30 


15 


48 


30 



82 



14 



E2 






14 


E 


43 


39 


27 


43 


DCT 




44 


DCT 




43 


38 


26 


44 


29 


1D 


45 


29 


1D 



Appendix A: Field-to-Record Cross-Reference 137 



Field Description 

Lines to start, number of 
Logical port DCTs, number of 

Logical ports active when STOP was received, number of 

Logical record size, maximum 

Logical records, number written 

Logical records in overflow and prime data areas, number of 

logon identifier of user 

LOGON record 

Macro instruction and option types 

Maximum logical record size 

Maximum number of readers supported 

Maximum number of writers supported 

Modified lines, number of 

Modified remote characteristics 

MODIFY command type 

Module identification 

MSF data recording devices 

MSF device recording controls 

MSF indicator 

Name of catalog 



Record 
Type 

43 



Offset 
Dec. Hex. 



41 



29 



Name of component or cluster 

Name of copy modification module 
Name of data set 

Name of entry 
Name of flash overlay 



43 


39 


27 


43 


40 


28 


45 


30 


1E 


64 


DSC 




6 


47 


2F 


14 


ISAM 




15 


ISAM 




5 


76 


4C 


6 


57 


39 


47 


72 


48 


49 


72 


48 


14 


243 


F3 


14 


ISAM 




15 


243 


F3 


15 


ISAM 




64 


DSC 




43 


36 


24 


43 


37 


25 


44 


29 


1D 


44 


VTAM 




44 


28 


1C 


19 


62 


3E 


22 


MSS 




22 


MSS 




22 


MSS 




62 


42 


2A 


63 


44 


2C 


64 


40 


28 


67 


40 


28 


68 


38 


26 


69 


52 


34 


62 


92 


5C 


64 


84 


54 


6 


89 


59 


17 


40 


28 


18 


40 


28 


18 


84 


54 


63 


88 


58 


67 


84 


54 


68 


82 


52 


68 


126 


7E 



93 



5C 
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Field Description 
Name of job 



Name of locally attached intelligent controller 
Name of program 
Name of programmer 

Name of RTAM start procedure 
Name of step 

I 

Names of translate table 
New catalog record 

New catalog record size 

f New data set name 
New entry name 
Noise blocks, number of 
Number of attentions received 
Number of blocks per volume 

Number of buffers used in read channel programs 

Number of bytes in real storage 

Number of bytes in SMF buffer 

Number of bytes in virtual storage 

Number of card-image records in DD DATA and DD* 
data sets read for step/job 

Number of cleaner actions 

Number of copies flashed 

Number of cylinders in independent index, prime data, and 
independent overflow areas 

Number of cylinders in largest continuous unallocated area 

2 Programmed Cryptographic Facility (5740-XY5) 



Record 


Offset 


Type 


Dec. 


Hex. 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 


18 


14 


E 


20 


14 


E 


62 


14 


E 


63 


14 


E 


64 


14 


E 


67 


14 


E 


68 


14 


E 


69 


14 


E 


82 


20 


142 


50 


14 


E 


4 


54 


36 


5 


93 


5D 


20 


40 


28 


43 


20 


14 


44 


20 


14 


45 


20 


14 


4 


62 


3E 


82 


28 


1C 2 


6 


73 


49 


63 


132 


84 


67 


130 


82 


63 


40 


28 


67 


128 


80 


18 


84 


54 


68 


126 


7E 


21 


34 


22 


50 


34 


22 


14 


TAPD 




15 


TAPD 




50 


50 


32 





27 


18 





18 


12 





22 


16 


4 


47 


2F 


5 


47 


2F 


21 


37 


25 


6 


97 


61 


14 


ISAM 




15 


ISAM 





69 



48 



30 
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Field Description 

^Number of cylinders in largest unallocated extent 
Number of data set sequences 

Number of data sets processed by writer 
Number of devices requested during allocation 

Number of DSCBs 
Number of DSCBOs 
Number of erase gaps 
Number of EXCPs 

Number of extents 



Number of extents in independent index, prime data, and 
independent overflow areas 

Number of extents released by DADSM routine 



Number of free data space extents 
Number of full cylinder overflow areas 

Number of index levels 

Number of job classes 

Number of line DCTs 

Number of LINE table entries 

Number of lines modified 

Number of lines started when STOP was received 

Number of lines to start 

Number of logical port DCTs 

Number of logical ports active when STOP was received 
Number of logical records in overflow and prime data areas 

Number of logical records written 
Number of noise blocks 



Number of partition 
^Nviumber of 



partition page-ins 
Number of partition page-outs 
Number of permanent read errors 



Record 


Offset 


Type 


Dec. 


Hex. 


19 


52 


34 


14 


TAPU 




15 


TAPU 




6 


52 


34 


14 


50 


32 


15 


50 


32 


19 


42 


2A 


19 


44 


2C 


21 


35 


23 


4 


DEV 




14 


UCB 




15 


UCB 




64 


STAT 




14 


UCB 




15 


UCB 




64 


STAT 




14 


ISAM 




15 


ISAM 




14 


DCB 




15 


DCB 




69 


42 


2A 


14 


ISAM 




15 


ISAM 




14 


ISAM 




15 


ISAM 




64 


STAT 




13 


PAR 




43 


39 


27 


43 


38 


26 


44 


29 


1D 


45 


29 


1D 


43 


41 


29 


43 


39 


27 


43 


40 


28 


45 


30 


1E 


14 


ISAM 




15 


ISAM 




6 


47 


2F 


21 


34 


22 


13 


PAR 




4 


REL 




4 


REL 




21 


32 


20 



i 
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Field Description 

•——Number of permanent write errors 

Number of PI Us inbound 

Number of PI Us outbound 
( Number of read channel programs 

Number of read or write accesses to an overflow record 

Number of readers supported, maximum 

Number of records deleted, inserted, updated, and retrieved 
from component 

Number of records in component 

Number of records lost 

Number of slowdowns entered by locally attached 
intelligent controller 

Number of split control areas 

Number of split control intervals 

Number of START I /Os 

Number of step 



Number of steps in job 
^^TM umber of 



system page-ins 

Number of system page-outs 

• Number of system page reclaims 

Number of TCBs needed for dump-load-restart operation 

Number of temporary read errors 

Number of temporary write errors 

Number of times ending status of read channel 
program includes ATTN 

Number of tracks allocated on device 

Number of tracks in largest unallocated extent 
Number of tracks in largest continuous unallocated area 
Number of tracks in overflow area 

Number of tracks released by DADSM routine 

Number of tracks requested but not allocated 
Number of unallocated extents 
Number of unallocated cylinders 



Record 


Offs 


et 


Type 


Dec. 


Hex, 


21 


33 


21 


50 


42 


2A 


50 


46 


2E 


50 


30 


1E 


14 


ISAM 




15 


ISAM 




43 


36 


24 


64 


STAT 




64 


STAT 




7 


14 


E 


50 


54 


36 


64 


STAT 




64 


STAT 




21 


30 


1E 


4 


38 


26 


5 


38 


26 


1 


22 


16 


12 


22 


16 


1 


26 


1A 


12 


26 . 


1A 


1 


30 


1E 


12 


30 


1E 


50 


22 


16 


21 


28 


1C 


21 


29 


1D 


50 


38 


26 


14 


UCB 




15 


UCB 




19 


54 


36 


69 


50 


32 


14 


ISAM 




15 


ISAM 




14 


DCB 




15 


DCB 




64 


128 


80 


19 


56 


38 


19 


48 


30 


69 


44 


2C 
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Field Description 

Number of unallocated tracks 

Number of unused alternate tracks 
Number of unused control intervals 
Number of volumes 

Number of write channel programs 

Number of writers supported, maximum 

Old catalog record 

Old catalog record size 

Old data set name 

Old entry name 

OPEN routine indicator 

OPTCD=J output indicator 
Open status indicator 
Options, SMF 

Owner identification of direct access volume 
-ins, partition 
3-ins, system 



Page-outs, partition 
Page-outs, system 

Page reclaims, system 

Partition page-ins 
Partition page-outs 
Partition number 
Partition size requested 
Passback area 

Permanent read errors, number of 
Permanent write errors, number of 
PIUs inbound, number of 
PI Us outbound, number of 
Priority, job 
Priority, step 



Record 


Offs 


set 




Type 


Dec. 


Hex. 


I 


19 


50 


32 


n 


69 


46 


2E 




19 


46 


2E 




64 


STAT 






17 


87 


57 




18 


131 


83 




62 


136 


88 




50 


26 


1A 




43 


37 


25 




63 


132 


84 




63 


42 


2A 




18 


40 


28 




68 


82 


52 




14 


245 


F5 




15 


245 


F5 




6 


98 


62 




62 


38 


26 







26 


1A 




19 


22 


16 


/ 


4 


REL 




\ 


1 


22 


16 




12 


22 


16 




4 


REL 






1 


26 


1A 




12 


26 


1A 




1 


30 


1E 




12 


30 


1E 




4 


REL 






4 


REL 






13 


PAR 






4 


70 


46 




47 


68 


44 




49 


68 


44 




21 


32 


20 




21 


33 


21 




50 


42 


2A 




50 


46 


2E 




5 


53 


35 




4 


53 


35 
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Field Description 

Program name 

Program start time 

Programmed Cryptographic Facility 
CKDS activity flags 
function code 
installation exit data 
number of variable relocate sections 
options 
return code 

Programmer's name 
QID entry 

RBA, highest used 

Read channel programs, number of 

Read errors, number of 

Read or write accesses to an overflow record, number of 

Reader device class 
Reader end date 
Reader end time 
Reader start date 



Reader start time 



Record 


Offset 


Type 


Dec. 


Hex 


4 


54 


36 


4 


90 


5A 


82 2 






82 


KG 2 




82 


39 


272 


82 


I DAT 2 




82 


37 


252 


82 


CRYP 2 




82 


40 


28 2 


5 


93 


5D 


20 


40 


28 


47 


20 


14 


48 


20 


14 


49 


20 


14 


64 


130 


82 


50 


30 


1E 


21 


28 


1C 


21 


32 


20 


14 


ISAM 




15 


ISAM 




5 


69 


45 


5 


58 


3A 


5 


54 


36 


4 


26 


1A 


5 


26 


1A 


6 


26 


1A 


10 


26 


1A 


14 


26 


1A 


15 


26 


1A 


17 


26 


1A 


18 


26 


1A 


20 


26 


1A 


62 


26 


1A 


63 


26 


1A 


64 


26 


1A 


67 


26 


1A 


68 


26 


1A 


69 


26 


1A 


4 


22 


16 


5 


22 


16 


6 


22 


16 


10 


22 


16 


14 


22 


16 


15 


22 


16 


17 


22 


16 


18 


22 


16 


20 


22 


16 


62 


22 


16 


63 


22 


16 


64 


22 


16 


67 


22 


16 


68 


22 


16 


69 


22 


16 



Reader unit type 



2 Programmed Cryptographic Facilty (5740-XY5) 



70 



46 
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Field Description 

Readers supported, maximum number of 

Real storage, number of bytes in 

Real storage requested 

Record format 

Record indicator 



Record size, maximum logical 

Records, logical, number written 

Records deleted, inserted, updated, and retrieved from 
component, number of 

Records in component, number of 

Records in overflow and prime data areas, number of logical 

Record type 

Records lost, number of 

Relative address of JFCB or SIOT 

Relative address of last record processed for a physical 
sequential or partitioned data set 

Relative byte address, highest used 

Remote characteristics modified 

RETKEY flags 

RETKEY key name 

RTAM start procedure name 

Security Product ID 
SID parameter 
Situation indicator 
SIOT TTR address 

Size, partition requested 
Size of catalog record 

Size of control interval 

2 Programmed Cryptographic Facility (5740-XY5) 



Record 


Offset 


Type 


Dec. 


Hex 


43 


36 


24 





27 


1B 


4 


74 


4A 


14 


242 


F2 


15 


242 


F2 


4 


98 


62 


14 


38 


26 


15 


38 


26 


22 


14 


E 


63 


38 


26 


67 


38 


26 


64 


DSC 




6 


47 


2F 


64 


STAT 





64 



STAT 



14 


ISAM 




15 


ISAM 




ALL 


1 


1 


7 


14 


E 


14 


60 


3C 


15 


60 


3C 


14 


DCB 




15 


DCB 




64 


130 


82 


44 


VTAM 




82 


RETK 2 




82 


RETK 2 




43 


20 


14 


44 


20 


14 


45 


20 


14 


82 


18 


12 2 


ALL 


10 


A 


64 


38 


26 


14 


60 


3C 


15 


60 


3C 


4 


70 


46 


63 


40 


28 


63 


42 


2A 


67 


128 


80 



64 



DSC 
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Field Description 

Slowdown entered by locally attached intelligent controller, 
number of times 

SMF options 

Spindle identification 

SSID of device 

Staging adapters 

Staging spindles in staging data groups 

Start date of recording when SMF data set became available 

START l/Os, number of 

Start procedure name, RTAM 

Start time of recording when SMF data set became available 

Step accounting fields 
Step completion code 
Step CPU time 
Step name 

Step number 

Step priority 

Step termination date 

Step termination indicator 

Step termination time 

STOP command processing indicator 

Storage, real, number of bytes in 

Storage, real requested 

Storage, used 

Storage, virtual, number of bytes in 

Storage protect key 

Subsystem identification 



Record 
Type 

50 



Offset 
Dec. Hex. 



54 



26 



36 



1A 



64 


EXT 




69 


40 


28 


22 


VAR 




22 


MSS 




22 


MSS 




7 


20 


14 


21 


30 


IE 


43 


20 


14 


44 


20 


14 


45 


20 


14 


7 


16 


10 


4 


ACT 




4 


51 


33 


4 


ACT 




4 


62 


3E 


82 


28 


1C 2 


4 


38 


26 


4 


53 


35 


4 


6 


6 


4 


83 


53 


4 


2 


2 


45 


28 


1C 





27 


IB 


4 


74 


4A 


4 


74 


4A 





22 


16 


4 


82 


52 


5 


72 


48 


43 


14 


E 


44 


14 


E 


45 


14 


E 


47 


14 


E 


48 


14 


E 


49 


14 


E 



Subsystem identification of device 



22 



VAR 



2 Programmed Cryptographic Facility (5740-XY5) 
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Field Description 

SYSOUT class indicator 

SYSOUT start date 
SYSOUT start time 
System identification 
System indicator 
System page-ins 

System page-outs 

System page reclaims 

System wait time 

Tape density 

TCBs, number of 

Temporary read errors, number of 

Temporary write errors, number of 

Termination indicator, job 

Termination indicator, step 

Time, continuous wait 

Time, expiration of ten-minute intervals 

Time, job CPU 
"Time, step CPU 
'Time, system wait 

Time device allocation started 
Time initiator selected step/job 

Time job terminated 

Time program was started 

Time reader recognized end of job 

Time reader recognized the JOB card 



Record 


Offset 


Type 


Dec. 


Hex. 


5 


63 


3F 


6 


38 


26 


6 


43 


2B 


6 


39 


27 


ALL 


10 


A 


ALL 








1 


22 


16 


12 


22 


16 


1 


26 


1A 


12 


26 


1A 


1 


30 


1E 


12 


30 


1E 


1 


14 


E 


12 


14 


E 


21 


39 


27 


50 


22 


16 


21 


28 


1C 


21 


29 


1D 


5 


62 


3E 


4 


83 


53 





14 


E 


1 


18 


12 


12 


18 


12 


5 


113 


71 


4 


ACT 




1 


14 


E 


12 


14 


E 


4 


86 


56 


4 


39 


27 


5 


39 


27 


5 


2 


2 


4 


90 


5A 


5 


54 


36 


4 


22 


16 


5 


22 


16 


6 


22 


16 


10 


22 


16 


14 


22 


16 


15 


22 


16 


17 


22 


16 


18 


22 


16 


20 


22 


16 


62 


22 


16 


63 


22 


16 
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Field Description 

Time reader recognized the JOB card (cont'd) 



Time record was moved to dump data set 

Time record was moved to SMF buffer 

Time recording was started when SMF data set became available 

Time step terminated 

Time SYSOUT was started 

TIOT status indicator 

Tracks, number in largest unallocated extent 
Tracks, number of unallocated 

Tracks, number of unused alternate 
Tracks allocated on device, number of 

Tracks in largest continuous unallocated area, number of 
Tracks in overflow area, number of 

Tracks released by DADSM routine, number of 

Tracks requested but not allocated, number of 

Translate table names 
TTR of JFCB or SIOT 



TTRN of last record processed for a physical sequential or 
partitioned data set 

Type of I/O macro instruction and options 



Type of MODIFY command 
Unit address 



Record 


Off 


set 


Type 


Dec. 


Hex, 


64 


22 


16 


67 


22 


16 


68 


22 


16 


69 


22 


16 


2 


2 


2 


3 


2 


2 


ALL 1 


2 


2 


7 


16 


10 


4 


2 


2 


6 


39 


27 


14 


49 


31 


15 


49 


31 



19 

19 
69 

19 

14 
15 

69 



44 



54 

50 
46 

46 

UCB 
UCB 

50 



28 



36 

32 

2E 

2E 



32 



14 


ISAM 




15 


ISAM 




14 


DCB 




15 


DCB 




64 


128 


80 


6 


73 


49 


14 


60 


3C 


15 


60 


3C 


14 


DCB 




15 


DCB 




14 


243 


F3 


15 


243 


F3 



1C 



4 


DEV 




8 


DEV 




9 


DEV 




10 


DEV 




11 


DEV 




14 


UCB 




15 


UCB 




19 


61 


3D 


21 


23 


17 


43 


DCT 




44 


DCT 




64 


EXT 




69 


39 


27 



1 Except 2, 3, 4, and 5 
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Field Description 

Unit type 



Updated records, number of 
User identification 



User interface identification 
User's logon identifier 

Virtual storage, number of bytes in 
Volume owner identification 
Volume sequence number 

Volume serial number 



Volumes, number of 

VTOC address 

VTOC indicator 

Write channel programs, number of 

Write errors, number of 

Writers supported, maximum number of 
3800 accounting information 



Record 


Offset 




Type 


Dec. 


Hex, 


5 


70 


46 


8 


DEV 




9 


DEV 




10 


DEV 




11 


DEV 




14 


UCB 




15 


UCB 




19 


32 


20 


21 


24 


18 


62 


VOL 




64 


EXT 





64 



51 



STAT 



4 


30 


1E 


5 


30 


1E 


6 


30 


1E 


10 


30 


1E 


14 


30 


1E 


15 


30 


1E 


17 


30 


1E 


18 


30 


1E 


20 


30 


1E 


44 


VTAM 




62 


30 


1E 


63 


30 


1E 


64 


30 


1E 


67 


30 


1E 


68 


30 


1E 


69 


30 


1E 



14 



5 


76 


4C 


6 


57 


39 





22 


16 


19 


22 


16 


14 


250 


FA 


15 


250 


FA 


14 


UCB 




15 


UCB 




17 


VOL 




18 


VOL 




19 


16 


10 


21 


16 


10 


62 


86 


56 


62 


VOL 




64 


EXT 




69 


96 


60 


17 


87 


57 


19 


36 


24 


19 


41 


29 


50 


26 


1A 


21 


29 


1D 


21 


33 


21 


43 


37 


25 


6 


65 


41 
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Appendix B: SMF Compatibility Between VS1 and MFT 



VSl SMF and MFT SMF are compatible with the following exceptions: 

• SYSGEN procedures — The MFT procedures for adding SMF and user-written 
exit routines to the operating system differ from the VSl SYSGEN procedures. 

• SMF data sets - You must catalog the VSl SYS1 .MANX and SYS1 .MANY data 
sets on direct access devices (DASD). 

• SMF exits - Three new SMF exits, IEFUIV, IEFU83, and IEFUJP, have been 
added for VSl. 

• SMF SYS 1 .PARMLIB member - The MFT SMFDEFLT member of 
SYS1 .PARMLIB has been replaced with the VSl SMFxxxxx member. An 
IBM-default member, SMFPRMOO, has also been added. 

• SMF parameters - The MFT SMFDEFLT parameters ALT, MDL, and PRM are 

not supported by VSl . The VSl SID parameter specifies both the system and 
the model on which SMF is active; its length is four bytes. 

• SMF buffer size — The MFT BUF parameter can have a value from 400 to 
65,536 bytes; the VSl BUF parameter can have a value from 400 to 8,192 bytes. 

• Common exit parameter area - VSl data statistics (88 bytes) have been added to 
the common exit parameter area, especially for use by the IEFUJP exit. 

• Sample SMF routines — MFT sample routines of SYS1 .SAMPLIB have been 
added to the VSl SYS1 .ASAMPLIB data set. The MFT sample source report 
program, SMFPOST, has been changed to the VSl sample program called 
SMFFRMT. The MFT sample sort exit routines SMFE35A and SMFE35B have 
been changed to the VSl sample routine called SMFE35. 

• Writing to installation-defined data sets - In MFT, exits IEFUJI, IEFUSI, and 
IEFACTRT cannot write to installation-defined data sets; in VSl , they can. 

• SMF records — Several record types have been added, deleted and modified for 
VSl . Figure 35 lists these record types and the corresponding changes. 

• SMF record fields - The VSl values for fields such as CPU time, storage 
allocated and used, and EXCP count, may differ from the MFT values for these 
fields. 
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Record Types 


Additions, Deletions, and Modifications from MFT for VS1 


Header 


System indicator added. 





Size of virtual storage replaces size of main storage. Size of real 
storage added. 


1 


Expiration time of collection period and system page-ins, page-outs, 
and page reclaims for the interval added. 


4 


Requested partition size replaces allocation for hierarchy 0. Storage 
used replaces hierarchy storage used. Device entries for spooled 
data sets deleted. Step termination indicator and record indicator 
replace reserved fields. 


5 


ABEND bit in job termination indicator is set when any step abnor- 
mally terminates. Termination indicator bit for IEFUJV exit added. 
Job completion code contains ABEND code for the last step that 
abnormally terminated, regardless of normal processing by successive 
steps. Reserved field replaces checkpoint/restart indicator. User's 
logon identifier added. 


6 


User's logon identifier added. Accounting information for IBM 
3800 added. 


9 


Record written only for devices varied online. 


11 


Record written only for devices varied offline. 


12 


Expiration time of collection period and system page-ins, page-outs, 
and page reclaims for the interval added. 


13 


Record written only for storage assigned to problem program 
partitions. 


22 


Record added for configuration of mass storage devices. 


30-35, 38 and 40-42 


Records deleted. 


43-45 and 47-49 


Records added for RTAM 


50 


Record added for ACF/VTAM. 


51 


Record added for subsystems. 


62-64 and 67-69 


Records added for VSAM. 


82 


Record added for Programmed Cryptographic Facility (5740-XY5). 



Figure 35. Record Modifications from MFT for VS1 
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Index 



Indexes to 0S/VS1 publications are consolidated in OS/VS1 
Master Index. This master index references other 
publications that contain additional information about the 
subjects listed here. 

{> 6 
[] 6 

I 6 

accounting field format 52 

accounting records 14 

ACF/VTAM tuning statistics record (type 50) 116 

adding devices to configuration 91, 92, 107 

adding exit routines to operating system 24 

adding SMF to operating system 23 

addressing SMF record fields 49 

allocating space for SMF data sets 28 

allocation 

dynamic 80, 95 

recovery 92 
allocation recovery record (type 10) 92 
ALTER access method services command 

records written when issued 118,125 
altering VSAM catalog entries 118 
AMS commands (see commands, access method services) 
ASI (automated system initialization) 

defining SMF when using 39 
ASMFCL procedure 

sort procedure, use in 69 

TESTEXIT procedure, use in 63 
automated system initialization (ASI) 

defining SMF when using 39 
auxiliary storage requirements 26 

BASIC parameter 23 
BUF parameter 36 
buffer, SMF 

specifying size of 36 

storage requirements 27 
buffer size parameter (BUF) 36 



CANCEL operator command 

relation to allocation recovery record (type 10) 

relation to step termination record (type 4) 80 
cataloged procedures 

ASMFCL 

sort procedure, use in 69 
TESTEXIT procedure, use in 63 

defining installation data sets in 45 
cataloging SMF data sets 28 
clock, CPU 75,103 
closing magnetic tape volumes 106 
closing non-VSAM data sets 96, 100 
closing VSAM components or clusters 120 
cluster 

closing 120 

deleting 123 

opening 117 

renaming 125 
coding examples (see JCL examples) 
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95 



75,94,103 

111 

90 

110 
32 

112 



75,94,103 

93, 107 

91,107 

47 
149 



collecting wait time 76 
commands, access method services 
ALTER 118, 126 
DEFINE 123,126 
DELETE 118,125 
commands, operator 
CANCEL 80, 92 
DEFINE 

record written when issued 
HALT 

operation 32 
records written when issued 
MODIFY 

record written when issued 
SET 

record written when issued 
START 

record written when issued 
use with dump procedure 
STOP 

record written when issued 
SWITCH 

operation 32 
records written when issued 
VARY OFFLINE 

records written when issued 
VARY ONLINE 

records written when issued 
common exit parameter area 46 
communication among exit routines 
compatibility between VS1 and MFT 
component 

closing 120 
deleting 123 
opening 117 
renaming 125 
configuration 

adding devices to 91 , 92, 107 
removing devices from 93, 107 
configuration records 

direct access volumes (type 19) 
dynamic storage (type 13) 95 
I/O (type 8) 90 
MSS (type 22) 107 
VARY OFFLINE (type 1 1 ) 93 
VARY ONLINE (type 9) 91 
CPU clock 75, 103 
CPU time limits 54 
cryptographic facility (5740-XY5) 127 

data lost record (type 7) 89 
data set activity records 

INPUT or RDBACK (type 14) 96 

OUTPUT, UPDAT, INOUT or OUTIN (type 15) 100 
data set records 15 
data set status records 

rename (type 18) 102 ' 

scratch (type 17) 101 J 
data set/direct access volume parameter (DSV) 36, 38 
data sets 

DDDATA 80 

DD* 80 
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data sets (continued) 

installation-defined 45 

non-VSAM 96-102 

SMF (see SMF data sets) 

SYSOUT 87 

VSAM 117-125 
data-collection parameters 

data set/direct access volume (DSV) 36, 38 

SMF/user records (MAN) 36, 38 

system/job/step (OPT) 37, 38 

temporary data set (REC) 37, 38 
data-collection routines, SMF 

storage requirements 27 
DD DATA data sets 80 
DD* data sets 80 
DEFINE access method services command 

records written when issued 118, 126 
DEFINE operator command 

record written when issued 95 
defining the use of SMF 35 
defining VSAM catalog entries 118 
defining VSAM data spaces 126 
DELETE access method services command 

records written when issued 1 23 , 1 26 
deleting VSAM catalog entries 123 
deleting VSAM data spaces 126 
demounting user volumes 103 
designing a report program 70 
device allocation recovery record (type 10) 92 
devices 

direct access 103 

online at IPL 90, 107 

recovering 92 

varying offline 93,107 

varying online 91,107 
direct access volume record (type 19) 103 
direct access volume/data set parameter (DSV) 36, 38 
distribution libraries 

for adding exit routines 24 
DSV parameter 36, 38 
dump header record (type 2) 78 
dump program, SMF (see IFASMFDP) 
dump trailer record (type 3) 79 
dynamic storage configuration record (type 1 3) 95 

elapsed time 75 
end-of-day record (type 12) 94 
end-of-volume 
records written at 

for magnetic tape volumes 106 

for non-VSAM data sets 96, 100 

for VSAM catalog entries 118 
EOD (see end-of-day) 
EOV (see end-of-volume) 
error statistics by volume record (type 21) 106 
ESV record (type 21) 106 
ESV= parameter 106, 23 

event recording (see also IEFUTL, IEFUSO and IEFU83 
exits) 20 

examples (see also JCL examples) 

data set space requirements 28 

SMF in operating system 17 

SMFFRMT output 70 

wait time collection 76 
EXCP count 80 
exit parameter (EXT) 36 
exit routines, SMF 

adding to operating system 24 

available when SMF=BASIC or FULL 23 

characteristics of 41 



common parameters 46 

communicating among 47 

conventions 45 

facilities 46 

IEFACTRT (termination) 57 

IEFUIV (input stream validation) 50 

IEFUJI (job initiation) 52 

IEFUJP (job purge) 59 

IEFUJV (job validation) 50 

IEFUSI (step initiation) 5 3 

IEFUSO (SYSOUT limit) 55 

IEFUTL (time limit) 54 

IEFU83 (SMF record) 56 

introduction to 19,41 

load module assignments for 24 

modules interfacing with 42-43 

obtaining additional work areas for 48 

parameters passed to 42-43 

restrictions 45 

return codes 42-43 

sample routines 43 

storage requirements 27 

testing 59 

using installation-defined data sets with 45 

when taken 42-43 

writing to SMF-defined data sets from 48 
EXT parameter 36 
extending VSAM catalog entries 118 
extending VSAM data spaces 126 

FREEMAIN macro instruction 48 
FULL parameter 23 

GETMAIN macro instruction 48, 60 
generation data group (GDG) data sets 96 
GENKEY recording (5740- XY5) 1 27 

HALT operator command 
function 32 
records written when issued 

direct access volume (type 19) 103 
end-of-day (type 12) 94 
system statistics (type 1) 75 
header, standard SMF record 71 

I/O configuration record (type 8) 90 
I/O macro instruction (SMFWTM) 

format 48 

RDW used with 48, 71 

return codes 49 

TESTEXIT definition of 6 1 
ICBMSG00 

records written by 91,93 
ICTVKG00 (5740-XY5) 

record written by 127 
ICTVKM01 (5740-XY5) 

record written by 127 
ICTVKM04 (5740-XY5) 

record written by 1 27 
IDA0192A 

record written by 117 
IDA0192S 

records written by 117,120 
IDA0200B 

record written by 120 
IDA0231B 

record written by 120 
IDA0557A 

record written by 120 
IEBDG utility program 

creating sample parameter lists with 63, 60 
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IEBPTPCH utility program 

use in obtaining listings of 
sample exit routines 43 
sample sort exit routines 68 
TESTEXIT 62 
IEBUPDTE utility program 

adding exit routines to EXITLIB with 62 

adding SMFxxxxx to SYS1.PARMLIB with 39 

executing SMF dump program with 32 

executing TESTEXIT with 63 
IEEDFINA 

record written by 95 
IEELGON1 

records written by 113,115 
IEESMFI2 

records written by 

I/O configuration (type 8) 90 
IPL (type 0) 74 
job initiation (type 20) 105 
system statistics (type 1) 75 
IEESMFWT 

record written by 89 
IEE1403D 

record written by 94 
IEE2303D 

record written by 91 
IEFACTRT exit routine 57 

parameters passed 57 

return codes 58 

sample routine 44 

writing system output messages 57 
IEFOSC01 

record written by 87 
IEFOSC02 

record written by 87 
IEFOSC05 

record written by 87 
IEFOSC09 

record written by 87 
IEFSMFLK 

records written by 

job termination record (type 5) 84 
step termination record (type 4) 80 
system statistics record (type 1) 75 
IEFSMFWI 

records written by 80, 84 
IEFUIV exit routine 50 

parameters passed 50 

return codes 50 
IEFUJI exit routine 52 

parameters passed 52 

return codes 53 

sample routine 44 
IEFUJP exit routine 59 

parameters passed 59 

return codes 59 
IEFUJV exit routine 50 

parameters passed 51 

return codes 52 

sample routine 43 
IEFUSI exit routine 53 

parameters passed 53 

return codes 53 
IEFUSO exit routine 55 

parameters passed 56 

return codes 56 
IEFUTL exit routine 54 

parameters passed 55 

return codes 55 

sample routine 44 



IEFU83 exit routine 56 

parameters passed 59 

return codes 59 

sample routine 44 
IEFXCSSS 

record written by 93 
IEFXJIMP 

record written by 92 
IEFZHMSG 

record written by 93 
IFASMFDP dump program 

introduction 20 

records written by 78, 79 

sample JCL for executing 31 

sample procedure using START command 32 
IF ASMFR macro instruction 49 
IFG0202H 

records written by 96,100 
IFG0202I 

records written by 96, 100 
IFHSTATR utility program 106 
IFSCMD 

records written by 111,112 
IFSINIT 

record written by 110 
IFSLOGON 

records written by 114,115 
IFSSTAE 

record written by 112 
IGC0009A 

record written by 106 
IGO0107H 

record written by 103 
IGC126 

record written by 107 
IGG0CLBV 

records written by 

VSAM data space defined, extended 
or deleted (type 69) 126 
VSAM entry defined (type 63) 118 
VSAM entry deleted (type 67) 123 
VSAM entry renamed (type 68) 125 
IGG0290D 

record written by 101 
IGG03001 

record written by 102 
including exit routines in operating system 24 
including SMF in operating system 23 
initial program load (see IPL) 
initialization 

RTAM 110 

SMF 17 
initializing SMF 17 
initiation record 

job (type 20) 105 
initiator 52, 53 
INOUT, OUTPUT, UPDAT or OUTIN data set activity record 

(type 15) 100 
INPUT or RDBACK data set activity record (type 14) 96 
input stream validation control routine 50 
input stream validation exit routine (see IEFUIV exit routine) 
input/output (see I/O) 
installation-defined data sets 45 
installation-written routines (see user-written routines) 
integrity 

RTAM record for 115 
interlock warning 54 
IPL records 

configuration (type 22) 107 

direct access volume (type 19) 1 03 

I/O configuration (type 8) 90 

IPL (type 0) 74 

system statistics (type 1) 75 
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JCL examples 

adding exit routines to EXITLIB 62 

adding exit routines to SYS1 .LINKLIB 25 

adding exit routines to SYS 1 .NUCLEUS 26 

adding SMFPRM01 to SYS1.PARMLIB 39 

allocating space for SMF data sets 28 

cataloging SMF data sets 28 

dumping SMF data sets using START command 32 

executing SMF dump program 31 

executing SMFFRMT 70 

executing a sort procedure 68 

executing TESTEXIT 63 

obtaining a listing of sample exit routines 43 

obtaining a listing of sample sort exit routines 68 

obtaining a punched deck of TESTEXIT 62 
JES (job entry subsystem) 13,55 
JES macro instruction 

JOBLOG parameter 47 

JOUTLIM parameter 55,23 
job CPU time limit 54 
job entry subsystem (JES) 13, 55 
job initiation exit routine {see IEFUJI exit routine) 
job initiation record (type 20) 105 
job management 50 

job purge exit routine {see IEFUJP exit routine) 
job termination following ten-minute interval expiration 75 
job termination record (type 5) 84 
job time 75 

job validation exit routine {see IEFUJV exit routine) 
job wait time limit 

changing value of 54 

recording 75 

specifying (JWT parameter) 36 
JOBLOG parameter 47 
JOUTLIM parameter 55, 23 
JWT parameter {see also job wait time limit) 36 

keys, storage protect 45 

libraries, distribution 

for adding exit routines 24 
libraries, system {see SYSljcxxxxxx) 
line modification 111 
load module assignments for exit routines 24 
logging off RTAM user 114 
logging on RTAM user 113,115 

macro instructions 

FREEMAIN 48 

GETMAIN 48, 60 

IFASMFR 49 

JES 55,23,47 

SCHEDULR 106, 23 

SMFWTM 48 
magnetic tape volumes 

error statistics record for 106 
MAN parameter 36, 38 
MANX data set 

SMFWTM macro definition for writing to 61 
mass storage control (MSC) 

configuration 107 

varying offline 93 

varying online 91 
messages, SYSOUT 

from IEFACTRT 57 

from IFASMFDP 31 
MFT and VS1 compatibility 149 
MODIFY rtam operator command 

record written when issued 111 
modifying a line 111 
modifying a VTAM user 111 



module assignments for exit routines 24 
modules interfacing with exit routines 4243 
MSC {see mass storage control) 

non-VSAM data set activity records 

INPUT or RDBACK (type 14) 96 

OUTPUT, UPDAT, INOUT or OUTIN (type 15) 1 00 
non-VSAM data sets 

closing 96, 100 

renaming 102 

scratching 101 
NOTSUPPLIED parameter 23 
nucleus, pageable 

SMF storage requirements for 27 

opening 

generation data group (GDG) data sets 96 

VSAM components or clusters 117 
operating system 

including exit routines in 24 

including SMF in 23 

relationship of SMF in 17 
operation of SMF, example of 18 
operator commands {see commands, operator) 
operator intervention parameter (OPI) 37 
OPI parameter 37 
OPT parameter 37, 38 
OUTIN, OUTPUT, UPDAT or INOUT data set activity record 

(type 15) 100 
OUTLIM parameter 55 
OUTPUT, UPDAT, INOUT or OUTIN data set activity record 

(type 15) 100 
output writer record (type 6) 87 
output writer routine 59 

parameter area, common exit 46 
parameters, SMFxxxxx 

adding or replacing from console 39 

coding restrictions 39 

contents and formats 36 

defaults 38 

entering into SYS1 .PARMLIB 38 

selecting records using 38 

verification of 17 
partition queue area (PQA) 

SMF storage requirements for 27 

subpools in 48 
performance, SMF 33 
PQA (partition queue area) 

SMF storage requirements for 27 

subpools in 48 
Programmed Cryptographic Facility (5 740 - XY5 ) 127 

RDBACK or INPUT data set activity record (type 14) 96 

RDW (record descriptor word) 71, 48, 49 

real storage requirements, SMF 26 

REC parameter 37, 38 

record descriptor word (RDW) 71 , 48, 49 

record length 

minimum for using sort 67 
record modifications 

from MFT for VS1 146 
recording not available record (type 7) 89 
records, SMF 

contents and formats 74 

introduction to 13-17 

segmenting 27, 31 

selecting 38 

sizes 28 

sorting 67 
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records, SMF (continued) 

standard header 71 

summary of 72 

types (see "CONTENTS" for specific SMF record types) 
recovery 

allocation record (type 10) 92 
reenterable attribute 45 
register usage 45 

removing devices from configuration 93, 107 
renaming non-VSAM data sets 102 
renaming VSAM catalog entries 125 
report programs 

designing 70 

introduction 21 

sample (SMFFRMT) 70 
restrictions, exit routine (see also restrictions, SMF) 

adding or modifying JCL cards 50, 5 1 

coding TIME=1440 54 

communicating with IEFU83 59 

extending job/ step execution time 54 

reenterable attribute 45 

resolving symbolic parameters 51 

system interlock 54 

writing to installation-defined data sets 45 

writing to SMF-defined data sets 48 
restrictions, SMF (see also restrictions, exit routine) 

coding SMFxxxxx parameters 39 

DCB= keyword with SMF dump program 31 

maximum SYSOUT message length 57 

minimum record length for sort 67 

reducing SMF buffer size 28, 36 
RETKEY recording (5740-XY5) 127 
return codes 

IEFACTRT exit routine 53 

IEFUIV exit routine 50 

IEFUJI exit routine 53 

IEFUJP exit routine 59 

IEFUJV exit routine 52 

IEFUSI exit routine 53 

IEFUSO exit routine 56 

IEFUTL exit routine 55 

IEFU8 3 exit routine 56 

SMF dump program 31 

SMFWTM macro instruction 49 
routines, user-written 

exit (see exit routines, SMF) 

report 

designing 70 
introduction 21 
sample (SMFFRMT) 70 
RTAM initialization 110 
RTAM integrity record (type 49) 115 
RTAM logoff record (type 48) 114 
RTAM logon record (type 47 ) 113 
RTAM modify record (type 44) 111 
RTAM start record (type 43) 110 
RTAM stop record (type 45) 112 

sample exit routines 43 
sample report program 70 
sample sort exit routines 67 
sample sort procedure 68 
saving registers 45 
SCHEDULR macro instruction 

ESV= parameter 106, 23 

SMF= parameter 23 
scratching non-VSAM data sets 101 
security record (.type 82) (5740-XV5) 127 
selecting SMF records 

using SMFxxxxx parameters 38 



SET DATE operator command 

record written when issued 90 
SID parameter 37 
sizes of SMF records 28 

minimum for using sort 67 
SMCA (system management control area) 

storage requirements 27 
SMF 

defining the use of 35 

definition of 13 

exits (see exit routines, SMF) 

including in operating system 27 

initializing 17 

operation, example of 17 

performance 33 

records (see records, SMF) 

storage requirements 26 

system-task restriction 1 3 
SMF buffer 

specifying size of 36 

storage requirements 27 
SMF data sets 

allocating space for 28 

cataloging 28 

determining which to write to first 19 

dumping 31 

specifying in SMFxxxxx parameters 35 

storage requirements 28 

switching 32 

writing to using SMFWTM macro 48 
SMF dump program (see IFASMFDP) 
SMF exit parameter (EXT) 36 
SMF exit routines (see exit routines, SMF) 
SMF options 

list of 47 
SMF performance 33 

SMF record exit routine (see IEFU83 exit routine) 
SMF records (see records, SMF) 
SMF= parameter 23 

SMF/user records parameter (MAN) 36, 38 
SMFEXITS sample exit routines 43 
SMFE15 sample sort routine 67 
SMFE35 sample sort routine 67 
SMFFRMT procedure 70 
SMFSORT procedure 68 
SMFWTM macro instruction 

format 48 

RDW used with 48,49,71 

return codes 49 

TESTEXIT definition of 61 
SMFxxxxx parameters 

adding or replacing from console 39 

coding restrictions 39 

contents and formats 36 

defaults 38 

entering into SYS1 .PARMLIB 38 

selecting records using 38 

verification of 17 
sorting SMF records 

introduction 21 

minimum record length 45 

sample sort exit routines 67 

sample sort procedure 69 
space unavailable on VSAM volumes 120 
SQA (system queue area) 

SMF storage requirements for 27 

subpools in 48 
standard SMF header 71 
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START operator command 

record written when issued 110 

use with SMF dump program 32 
step CPU time limit 54 

step initiation exit routine (see IEFUSI exit routine) 
step termination 

following ten-minute interval expiration 75 
step termination record (type 4) 96 
STOP button 

relation to wait time 75 
STOP rtam operator command 

record written when issued 112 
storage protect keys 45 
storage requirements, SMF 26 
subpools 

required for additional work areas 48 

required when using TESTEXIT 60 
subsystem records 15 
SVC 83 routine 56 
SWITCH operator command 

function 32 

records written when issued 

direct access volume (type 19) 103 
end-of-day (type 12) 94 
system statistics (type 1) 75 
switching recording on SMF data sets 32 
switching VSAM volumes 1 20 
symbolically addressing SMF record fields 49 
SYSGEN 

macro instructions 
JES 55,23,47 
SCHEDULR 23, 106 

procedure for adding SMF to operating system 23 
SYSOUT class processing 

record written for 87 
SYSOUT data sets 87 

SYSOUT limit exit routine (see IEFUSO exit routine) 
SYSOUT messages 

from IEFACTRT 57 

from IFASMFDP 31 
SYSOUT writer routine 59 
system generation (see SYSGEN) 
system identification parameter (SID) 37 
system interlock warning 54 
system libraries (see SYSIjcxxxxxx) 
system management control area (SMCA) 

storage requirements 27 
system output messages 

from IEFACTRT 57 

from IFASMFDP 31 
system queue area (SQA) 

SMF storage requirement for 27 

subpools in 48 
system records 16 
system statistics record (type 1) 75 
system time 75 

system/job/ step parameter (OPT) 37, 38 
SYS1.AMODGEN 49 
SYS1.AOS00 

adding exit routines to 24 
SYS1.ASAMPLIB 

SMFEXITS 43 

SMFE15 67 

SMFE35 67 

SMFFRMT 70 

SMFSORT 68 

TESTEXIT 96 
SYS1.LINKLIB 

adding exit routines to 24, 25 



SYS1.MACLIB 48,49 
SYS 1 .MANX (see SMF data sets) 
SYS 1. MANY (see SMF data sets) 
SYS1. NUCLEUS 

adding exit routines to 24, 26 
SYS1.PARMLIB 

adding dump procedure to 32 

adding SMFxxxxx member to 38 

TCT (timing control table) 

storage requirements 27 
temporary data set parameter (REC) 37, 38 
termination 

job/ step following ten-minute interval expiration 75 
termination exit routine (see IEFACTRT exit routine) 
termination records 

job (type 5) 100 

step (type 4) 96 
TESTEXIT procedure 

execution, summary of 65 

exit routine requirements for 60 

input/output and control flow of 60 

modifying 65 

obtaining from SYS1 .ASAMPLIB 62 

sample JCL for invoking 63 
testing exit routines 59 
throughput 33 
time extension, minimum 54 
time limit exit routine (see IEFUTL exit routine) 
time limits 54 
TIME= parameter 

use in eliminating job/step timing 54, 96, 100 
timer interruption handler 54 
timer units 55 
timing control table (TCT) 

storage requirements 27 

UPDAT, OUTPUT, INOUT or OUTIN data set activity record 

(type 15) 100 
user-communication field 47 
user-defined data sets 45 
user-identification field 47 
user-written exit routines (see exit routines, SMF) 
user-written routines 

exit (see exit routines, SMF) 
report 

designing 70 
introduction 21 
sample (SMFFRMT) 70 
user/SMF records parameter (MAN) 36, 38 
utility programs (see IEBDG, IEBPTPCH, IEBUPDTE or 
IFHSTATR) 

VARY OFFLINE operator command 

record written when issued 93 
VARY OFFLINE,S operator command 

record written when issued 107 
VARY ONLINE operator command 

record written when issued 91 
VARY ONLINE ,S operator command 

record written when issued 107 
volume error statistics record (type 21) 106 
volume records 17 
volumes 

magnetic tape 106 

VSAM 120 
VSAM component or cluster opened record (type 62) 117 
VSAM component or cluster status record (type 64) 120 
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VSAM data sets 

records written for 1 1 7-1 26 
VSAM data space defined, extended, or deleted record 

(type 69) 126 
VSAM entry defined record (type 63) 118 
VSAM entry deleted record (type 67) 123 
VSAM entry renamed record (type 68) 125 
VS1 and MFT compatibility 149 
VTAM user modification 111 

wait time 

collecting and recording 76 

specifying limit of (JWT parameter) 36 
warm start parameter modifications 35 
work areas 

obtaining additional 48 
writer record (type 6) 87 
writer routine, SMF 

storage requirements 27 
writing system output messages 57 

3800 Printing Subsystem accounting 

information 87 
3850 mass storage control 

configuration 107 

varying offline 93 

varying online 91 
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